Filesystem MCP Server

Um servidor para realizar operações de sistema de arquivos, como leitura/escrita de arquivos, gerenciamento de diretórios e pesquisa.

Documentação

Filesystem MCP

Um servidor Model Context Protocol (MCP) que fornece acesso seguro ao sistema de arquivos para assistentes de IA no Code Maestro Desktop.

O que ele faz

Este servidor MCP permite que assistentes de IA:

  • Leiam e escrevam arquivos
  • Criem e naveguem em diretórios
  • Pesquisem arquivos
  • Editem arquivos existentes com precisão
  • E outras operações de sistema de arquivos

Todas as operações são restritas aos diretórios que você explicitamente permitir.

Por que este Fork?

Fizemos um fork do @modelcontextprotocol/server-filesystem original para torná-lo mais eficiente para assistentes de IA. O pacote original podia retornar saídas extremamente grandes que desperdiçam tokens e sobrecarregam modelos de linguagem.

Nossas melhorias:

  • Limites inteligentes de leitura de arquivos - Evita ler arquivos gigantes por completo
  • Limites de listagem de diretórios - Retorna resultados gerenciáveis mesmo em pastas com milhares de arquivos
  • Travessia de árvore com limite de profundidade - Evita se perder em estruturas de pastas profundas
  • Resultados de busca otimizados - Retorna correspondências relevantes sem inundar a saída
  • Pular pastas grandes - Ignora automaticamente node_modules, .git e diretórios semelhantes

Essas mudanças garantem que seu assistente de IA obtenha as informações necessárias sem se afogar em dados desnecessários.

Início Rápido

1. Abra o CM Desktop e clique em conectores

2. Clique em "Adicionar" e cole o seguinte 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. Substitua <YOUR_PROJECT_PATH> pelo caminho real do seu diretório de projeto

Exemplos de caminhos:

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

Você pode especificar vários diretórios:

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

Segurança

  • O servidor MCP pode SOMENTE acessar diretórios que você especificar explicitamente
  • Todas as operações de arquivo são registradas
  • Tentativas de acessar arquivos fora dos diretórios permitidos serão rejeitadas

Nota: Esta é uma solução temporária. Estamos trabalhando em suporte nativo a operações de arquivo no CM Desktop.