Filesystem MCP

A Model Context Protocol (MCP) server that provides secure filesystem access to AI assistants in Code Maestro Desktop.

What it does

This MCP server allows AI assistants to:

• Read and write files
• Create and navigate directories
• Search for files
• Edit existing files with precision
• And more filesystem operations

All operations are restricted to the directories you explicitly allow.

Why This Fork?

We forked the original @modelcontextprotocol/server-filesystem to make it more efficient for AI assistants. The original package could return extremely large outputs that waste tokens and overwhelm language models.

Our improvements:

• Smart file reading limits - Prevents reading gigantic files in full
• Directory listing caps - Returns manageable results even in folders with thousands of files
• Depth-limited tree traversal - Avoids getting lost in deep folder structures
• Optimized search results - Returns relevant matches without flooding the output
• Skip large folders - Automatically bypasses node_modules, .git, and similar directories

These changes ensure your AI assistant gets the information it needs without drowning in unnecessary data.

Quick Start

1. Open CM Desktop and click connectors

2. Click "Add" and paste the following JSON:

{
  "mcpServers": {
    "Code Maestro - Filesystem MCP": {
      "transport": "stdio",
      "enabled": true,
      "command": "npx",
      "args": [
        "github:codemaestroai/filesystem-mcp",
        "<YOUR_PROJECT_PATH>"
      ],
      "env": {},
      "url": null,
      "headers": null
    }
  }
}

3. Replace <YOUR_PROJECT_PATH> with the actual path to your project directory

Example paths:

• Windows: "C:\\Users\\YourName\\Projects\\my-project"
• macOS/Linux: "/home/username/projects/my-project"

You can specify multiple directories:

"args": [
  "github:codemaestroai/filesystem-mcp",
  "/path/to/project1",
  "/path/to/project2"
]

Security

• The MCP server can ONLY access directories you explicitly specify
• All file operations are logged
• Attempts to access files outside allowed directories will be rejected

Note: This is a temporary solution. We're working on native file operation support in CM Desktop.