mcpignore-filesystem MCP 服务器

“mcpignore-filesystem” MCP 服务器的作用是什么？

mcpignore-filesystem MCP 服务器 是一款基于 Node.js 的工具，通过为文件系统访问提供安全、细粒度的控制，提升了 AI 助理开发的工作流。在标准文件系统 MCP 服务器的基础上，该服务器引入了对 .mcpignore 文件的支持，使您能够限制 MCP 客户端（如 AI 代理）可操作的文件和目录。通过设置类似 .gitignore 的忽略模式，您可以保护敏感数据，确保只有被授权的文件可进行读取、写入、目录管理和搜索等操作。该服务器为涉及文件管理的开发任务提供了强大支撑，同时确保严格的数据安全和访问控制，非常适合需要为 AI 驱动工作流打造强大且可定制文件系统接口的团队。

提示模板列表

仓库中未提及任何提示模板。

资源列表

仓库中未记录任何显式 MCP 资源。

工具列表

• read_file：读取文件（若匹配 .mcpignore 模式则被阻止）。
• read_multiple_files：读取多个文件（若被忽略则阻止）。
• write_file：写入文件（若被忽略则阻止）。
• edit_file：编辑文件（若被忽略则阻止）。
• create_directory：创建目录（若被忽略则阻止）。
• list_directory：列出目录内容（若被忽略则阻止）。
• move_file：移动文件或目录（若被忽略则阻止）。
• get_file_info：获取文件元数据（若被忽略则阻止）。
• directory_tree：获取目录结构（允许，仅显示名称）。
• search_files：搜索文件（允许，仅显示名称）。
• list_allowed_directories：列出可访问的目录（不适用于忽略逻辑）。

该 MCP 服务器的应用场景

• 细粒度文件系统安全：开发者可为 AI 代理提供受控的项目目录访问，通过 .mcpignore 指定（如 .env、密钥、凭证等）敏感文件，保障安全。
• 安全的代码库探索：AI 工具可分析和浏览大型代码库，同时确保机密或专有文件不被暴露。
• 自动化文件管理：自动化诸如整理、搜索或跨目录移动文件等日常任务，并借助 .mcpignore 实现强访问限制。
• 协作开发环境：安全地向 AI 助理开放共享目录进行编辑或搜索，同时阻止访问内部或临时文件。
• 合规与审计：通过确保特定类型数据或文件对自动化工具不可访问，辅助数据合规和治理。

如何设置

Windsurf

仓库中未提供 Windsurf 的具体说明。

Claude

1. 确保已安装 Node.js 和 npx。
2. 打开 claude_desktop_config.json。
3. 按如下方式添加 MCP 服务器配置。
4. 保存文件并重启 Claude。
5. 验证服务器是否已启动并可访问。

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

API 密钥安全配置（示例）：

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

Cursor

1. 确保已安装 Node.js 和 npx。
2. 打开您的 mcp.json 配置文件。
3. 按如下方式添加服务器配置。
4. 保存文件并重启 Cursor。
5. 确认服务器连通性。

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

API 密钥安全配置：（参考上方 Claude 示例）

Cline

1. 确保已安装 Node.js 和 npx。
2. 打开 cline_mcp_settings.json。
3. 插入服务器配置。
4. 保存并重启 Cline。
5. 检查服务器可用性。

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

API 密钥安全配置：（参考上方 Claude 示例）

Windsurf

未提供设置说明。

如何在流程中使用此 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到 FlowHunt 工作流中，请先在流程中添加 MCP 组件并连接到您的 AI 代理：

点击 MCP 组件以打开配置面板。在系统 MCP 配置区域，使用如下 JSON 格式输入您的 MCP 服务器详情：

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

配置完成后，AI 代理即可作为工具使用此 MCP，访问其所有功能。请记得将 “mcpignore-filesystem” 替换为实际 MCP 服务器名称，并将 URL 替换为您的服务器地址。

概览

综上信息，该 MCP 服务器提供了强大且文档清晰的文件系统工具，并具备较强的安全特性，但缺少提示模板和资源模板，也未明确提及 Roots 或采样支持。因此，非常适用于需要安全、基于忽略规则的 AI 文件管理场景，但对于依赖提示模板或高级资源处理的工作流或许不太适合。

MCP 评分

评分：
我会为此 MCP 服务器打分 6/10。它在安全、工具文档和许可方面表现清晰，但缺少提示模板、资源定义，以及 Roots 或采样支持的证据。对于希望为 AI 代理实现安全、基于忽略规则文件访问的团队来说，它的价值最为突出。