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,.gite 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.