LocalFilesMcpServer 0.2.0-beta

LocalFilesMCP

LocalFilesMCP is an MCP server for file system operations, built with C# and the ModelContextProtocol SDK. It allows you to interact with the file system in a secure, sandboxed manner via the MCP protocol.

Command-Line Arguments

• --stdio Runs the server using standard input/output (stdio) transport. This is required for integration with tools like LM Studio or VS Code.

• --root-path <path> Sets the root directory for all file operations. All file and directory access will be confined to this path. Example:

  dotnet run -- --stdio --root-path "C:\My\Sandbox"
  
  

• --port Listener port for the server (only used if --stdio is NOT specified).

dotnet run -- --port 5000 --root-path "/home/user/sandbox"

If --root-path is not specified, the current working directory is used as the root. If --port is not specified, the server will listen on port 5000. If --stdio is not specified, the server will use HTTP/SSE transport.

Adding LocalFilesMCP to LM Studio

1. Build the project Run dotnet publish -c Release -r win-x64 to produce a standalone executable.
2. Locate the executable The output will be in bin/Release/net10.0/<your-platform>/publish/.
3. Configure LM Studio Create or edit the mcp.json file in your LM Studio workspace directory.
4. Add the server configuration Use the following example, updating the command path to your published executable and the --root-path as needed.

Example mcp.json for LM Studio

{
  "mcpServers": {
    "LocalFilesMCP": {
      "command": "C:\\Path\\To\\LocalFilesMCP.exe",
      "args": [
        "--stdio",
        "--root-path=C:\\Path\\To\\Your\\Sandbox"
      ]
    }
  }
}

Example mcp.json for CoPilot inVisual Studio

{
  "inputs": [],
  "servers": {
    "LocalFilesMCP": {
      "command": "C:\\Path\\To\\LocalFilesMCP.exe",
      "args": [
        "--stdio",
        "--root-path=C:\\Path\\To\\Your\\Sandbox"
      ],
      "env": {}
    },
    "OtherLocalFilesMCP": {
      "command": "C:\\Path\\To\\LocalFilesMCP.exe",
      "args": [
        "--stdio",
        "--root-path=C:\\Path\\To\\Your\\Other\\Sandbox"
      ],
      "env": {}
    }
  }
}

More Information

• ModelContextProtocol Documentation
• Use MCP servers in LM Studio
• Use MCP servers in VS Code

License

This project is licensed under the Apache License 2.0 with the Commons Clause.

What this means:

• Free for Personal Use: You can download, modify, and use this freely.
• Free for Internal Business Use: You can use this inside your company (e.g., game studios, enterprise workflows).
• No Commercial Resale: You cannot sell this software, offer it as a paid service, or wrap it in a commercial product for third parties.

See LICENSE.txt for the full legal text.