← 返回目录

Filesystem MCP Server

社区

教程 / 资源合集

通过标准输入输出访问本地项目文件。

这是教程或资源合集，本身不能安装到客户端使用。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 文件系统第 23 / 24
Stars: ★ 42.7k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Python
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 11 天前

35FMRS · D

源材料表明这是 Anthropic 管理仓库中的 stdio 文件系统配置示例，但该具体服务器并非明确由上游文件系统协议所有者维护；工具列表和客户端兼容性缺乏证据。

最强项 · 维护活跃度 11/20 最弱项 · 文档质量 5/20

可靠性

6/20

安全与权限

6/20

维护活跃度

11/20

文档质量

5/20

安装易用性

7/20

查看各项评分依据

可靠性 6/20: 清单仅展示三个启动配置，没有服务器源码、MCP 初始化/工具列表实现、测试或 CI 证据。filesystem 依赖未固定版本的 npx 包，database 依赖未提供的本地脚本和配置文件，custom-tools 依赖未证明存在的 Python 模块；custom-tools 还使用 --port 参数，与 stdio 定位存在不确定性。因此只能认为启动和握手在理想环境下可能成功，并因依赖、错误处理和真实工具行为均未验证而扣分。
安全与权限 6/20: 证据显示 filesystem 被授予 CLAUDE_PROJECT_DIR，database 使用 DATABASE_URL，custom-tools 使用 API_KEY，并可能访问外部数据库或服务。环境变量避免了在示例中直接暴露密钥，这是正面因素；但没有权限细分、路径边界说明、网络范围、危险操作确认、审计或数据流披露。未发现足以触发红线的恶意行为或真实秘密，因此不判定为红线，但权限控制证据不足导致明显扣分。
维护活跃度 11/20: 仓库标注为 Anthropic 管理、Apache-2.0 许可且未归档，说明存在明确归属和许可基础；但提供材料没有发布记录、提交频率、依赖更新策略、问题响应、漏洞报告或安全响应渠道。活跃度不能由 stars 推断，因此仅给中等分数。
文档质量 5/20: README 说明了插件目录、安装命令和总体结构，但没有针对该 manifest 的启动前置条件、三个入口的工具参数、认证要求、权限限制、平台兼容性、故障排查或成本说明。README 还明确提示无法验证所含 MCP 服务器，这进一步限制了可审查证据，因此文档分数较低。
安装易用性 7/20: README 提供了通过 Claude Code 插件市场安装的通用步骤，但没有该服务器的客户端配置示例、Node/Python 运行时要求、依赖安装、数据库配置、API key 设置或 stdio 连接验证步骤。npx、插件根目录文件和 Python 模块均引入未说明的环境假设，故安装路径可推测但较脆弱。

实测已过期收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络连接数据库

适合谁

需要让 MCP 客户端访问指定 Claude Code 项目目录的开发者。

不适合谁

需要数据库访问或自定义 API 工具的用户。
需要远程部署、SSE 或 streamable-http 传输的用户。

所需权限

需要访问 ${CLAUDE_PROJECT_DIR} 指定的本地项目目录。
具体读写权限取决于客户端、操作系统和服务器实现；源材料未明确说明权限范围。

风险与副作用

本地文件可能被 MCP 服务器访问；仅应指定你愿意授权的项目目录。
README 警告插件中的 MCP 服务器、文件或其他软件可能不受 Anthropic 控制，且无法保证按预期工作或不会产生变更。

安装接入

准备工作

运行环境：Node.js · Python

DATABASE_URL 可选密钥数据库连接字符串，由用户自己的数据库提供，示例中通过 ${DATABASE_URL} 从环境注入。

CUSTOM_API_KEY 可选密钥自定义 MCP 服务器的 API 密钥，由用户自己的服务提供，属敏感凭据。

其他可选配置项（3 个）

LOG_LEVEL 可选日志级别示例值，如 info，控制 MCP 服务器日志输出详细程度。

DB_POOL_SIZE 可选数据库连接池大小，示例中设为 10。

DEBUG 可选调试开关，示例中设为 false。

将该配置添加到支持 stdio MCP 服务器的客户端，并将 ${CLAUDE_PROJECT_DIR} 设置为目标项目目录。运行前请确认已安装 Node.js、npx，并信任相关插件和服务器软件。

MCP 配置 · JSON

{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","${CLAUDE_PROJECT_DIR}"],"env":{"LOG_LEVEL":"info"}}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "${CLAUDE_PROJECT_DIR}"
  ],
  "env": {
    "LOG_LEVEL": "info"
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

在 Claude Code 客户端中配置 filesystem MCP 服务器后，检查工具列表中是否出现文件系统相关工具，并让它列出当前目录文件以确认连接成功。

常见排障

确认 ${CLAUDE_PROJECT_DIR} 已解析为有效目录。
确认已安装 Node.js 和 npx。
检查客户端是否支持 stdio MCP 配置。
查看 LOG_LEVEL 为 info 的运行日志。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前项目目录下的所有文件
读取项目根目录的 README.md 内容
在项目里查找包含某个函数名的文件

使用场景

在项目目录范围内进行本地文件访问。

详细介绍

这是一个通过 stdio 运行的本地文件系统 MCP 服务器配置示例，使用项目目录作为访问目标。源材料未提供具体工具名称、客户端兼容性或更详细的能力说明。

同仓库的其他 Server

源版本 ea10b213686c 数据同步于 2026-10-19 查看 FMRS 评分方法