mcpignore-filesystem MCP Server

O que faz o MCP Server “mcpignore-filesystem”?

O mcpignore-filesystem MCP Server é uma ferramenta baseada em Node.js que aprimora fluxos de trabalho de desenvolvimento com assistentes de IA, fornecendo controle seguro e granular sobre o acesso ao sistema de arquivos. Com base no padrão Filesystem MCP Server, este servidor introduz suporte a arquivos .mcpignore, permitindo restringir quais arquivos e diretórios seus clientes MCP (como agentes de IA) podem acessar. Ao especificar padrões de ignore semelhantes ao .gitignore, você pode proteger dados sensíveis e garantir que apenas arquivos autorizados estejam disponíveis para operações como leitura, gravação, gerenciamento de diretórios e buscas. Este servidor potencializa tarefas de desenvolvimento envolvendo gerenciamento de arquivos, mantendo rigorosa segurança de dados e controles de acesso, sendo ideal para equipes que precisam de interfaces robustas e personalizáveis de sistema de arquivos para fluxos de trabalho orientados por IA.

Lista de Prompts

Nenhum template de prompt é mencionado no repositório.

Lista de Recursos

Nenhum recurso MCP explícito é documentado no repositório.

Lista de Ferramentas

• read_file: Lê um arquivo, a menos que corresponda a um padrão .mcpignore (Bloqueado para caminhos ignorados).
• read_multiple_files: Lê múltiplos arquivos, a menos que estejam ignorados (Bloqueado para caminhos ignorados).
• write_file: Escreve em um arquivo, a menos que esteja ignorado (Bloqueado para caminhos ignorados).
• edit_file: Edita um arquivo, a menos que esteja ignorado (Bloqueado para caminhos ignorados).
• create_directory: Cria um diretório, a menos que esteja ignorado (Bloqueado para caminhos ignorados).
• list_directory: Lista conteúdos de diretório, a menos que esteja ignorado (Bloqueado para caminhos ignorados).
• move_file: Move arquivos ou diretórios, a menos que estejam ignorados (Bloqueado para caminhos ignorados).
• get_file_info: Recupera metadados de arquivo, a menos que esteja ignorado (Bloqueado para caminhos ignorados).
• directory_tree: Recupera a estrutura dos diretórios (Permitido, apenas exibe nomes).
• search_files: Busca por arquivos (Permitido, apenas exibe nomes).
• list_allowed_directories: Lista diretórios permitidos para acesso (N/A para lógica de ignore).

Casos de Uso deste MCP Server

• Segurança Granular de Sistema de Arquivos: Desenvolvedores podem oferecer aos agentes de IA acesso controlado a diretórios de projetos, protegendo arquivos sensíveis (por exemplo, .env, segredos, credenciais) ao especificá-los no .mcpignore.
• Exploração Segura de Base de Código: Ferramentas de IA podem analisar e navegar grandes bases de código, garantindo que arquivos confidenciais ou proprietários fiquem excluídos da exposição.
• Gerenciamento Automatizado de Arquivos: Automatize tarefas rotineiras como organizar, buscar ou mover arquivos entre diretórios, com restrições de acesso robustas via .mcpignore.
• Ambientes de Desenvolvimento Colaborativo: Exponha com segurança diretórios compartilhados para assistentes orientados por IA editarem ou buscarem, bloqueando o acesso a arquivos internos ou temporários.
• Conformidade e Auditoria: Faça cumprir a conformidade de dados garantindo que tipos ou arquivos específicos permaneçam inacessíveis para ferramentas automatizadas, auxiliando em auditorias e governança.

Como configurar

Windsurf

Nenhuma instrução específica para Windsurf fornecida no repositório.

Claude

1. Certifique-se de que Node.js e npx estão instalados.
2. Abra seu claude_desktop_config.json.
3. Adicione a configuração do MCP server conforme mostrado abaixo.
4. Salve o arquivo e reinicie o Claude.
5. Verifique se o servidor está rodando e acessível.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Protegendo Chaves de API (exemplo):

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [ ... ],
      "env": {
        "API_KEY": "${MCP_SERVER_API_KEY}"
      },
      "inputs": {
        "api_key": "${MCP_SERVER_API_KEY}"
      }
    }
  }
}

Cursor

1. Certifique-se de que Node.js e npx estão instalados.
2. Abra seu arquivo de configuração mcp.json.
3. Adicione a configuração do servidor conforme abaixo.
4. Salve o arquivo e reinicie o Cursor.
5. Confirme a conectividade do servidor.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Protegendo Chaves de API: (veja exemplo do Claude acima)

Cline

1. Certifique-se de que Node.js e npx estão instalados.
2. Abra seu cline_mcp_settings.json.
3. Insira a configuração do servidor.
4. Salve e reinicie o Cline.
5. Verifique a disponibilidade do servidor.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Protegendo Chaves de API: (veja exemplo do Claude acima)

Windsurf

Nenhuma instrução de configuração fornecida.

Como utilizar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP utilizando este formato JSON:

{
  "mcpignore-filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de alterar “mcpignore-filesystem” para o nome real do seu servidor MCP e substituir a URL pela de seu próprio servidor MCP.

Visão Geral

Com base nas informações disponíveis, este servidor MCP oferece ferramentas de sistema de arquivos robustas e claramente documentadas, com fortes recursos de segurança, mas não possui templates de prompt e recursos. Também não há menção explícita a Roots nem suporte a Sampling. Assim, é uma escolha forte para gerenciamento seguro de arquivos, mas pode ser menos indicado para fluxos que exigem templates de prompt ou manipulação avançada de recursos.

Pontuação MCP

Nota:
Eu avaliaria este MCP server como 6/10. Tem foco claro em segurança, ferramentas documentadas e licença, mas falta templates de prompt, definições de recursos e evidências de roots ou suporte a sampling. Seu valor é mais forte para equipes que buscam acesso seguro ao sistema de arquivos, baseado em ignore, para agentes de IA.