“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
- 确保已安装 Node.js 和
npx。 - 打开
claude_desktop_config.json。 - 按如下方式添加 MCP 服务器配置。
- 保存文件并重启 Claude。
- 验证服务器是否已启动并可访问。
{
"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
- 确保已安装 Node.js 和
npx。 - 打开您的
mcp.json配置文件。 - 按如下方式添加服务器配置。
- 保存文件并重启 Cursor。
- 确认服务器连通性。
{
"mcpServers": {
"mcpignore-filesystem": {
"command": "npx",
"args": [
"-y",
"@cyberhaven/mcpignore-filesystem",
"/Users/<username>/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
API 密钥安全配置:(参考上方 Claude 示例)
Cline
- 确保已安装 Node.js 和
npx。 - 打开
cline_mcp_settings.json。 - 插入服务器配置。
- 保存并重启 Cline。
- 检查服务器可用性。
{
"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 客户端实现安全、基于 .mcpignore 的文件系统 |
| 提示模板列表 | ⛔ | 未记录提示模板 |
| 资源列表 | ⛔ | 未列出显式资源 |
| 工具列表 | ✅ | README 有详细说明,涵盖读取/写入/编辑/搜索/移动/列表等 |
| API 密钥安全配置 | ✅ | 配置中有 env/inputs 示例 |
| 采样支持(评估时不重要) | ⛔ | 未提及 |
综上信息,该 MCP 服务器提供了强大且文档清晰的文件系统工具,并具备较强的安全特性,但缺少提示模板和资源模板,也未明确提及 Roots 或采样支持。因此,非常适用于需要安全、基于忽略规则的 AI 文件管理场景,但对于依赖提示模板或高级资源处理的工作流或许不太适合。
MCP 评分
| 是否有 LICENSE | ✅ (MIT) |
|---|---|
| 是否有至少一个工具 | ✅ |
| 分支数量 | 0 |
| Star 数量 | 0 |
评分:
我会为此 MCP 服务器打分 6/10。它在安全、工具文档和许可方面表现清晰,但缺少提示模板、资源定义,以及 Roots 或采样支持的证据。对于希望为 AI 代理实现安全、基于忽略规则文件访问的团队来说,它的价值最为突出。
