MCP 文件系统 Python

一个提供对指定目录中的文件进行安全、只读访问的模型上下文协议（MCP）服务器。

特性

• 使用 file:// URI 方案将文件暴露为 MCP 资源
• 通过 MCP 工具提供文件搜索功能
• 尊重 .gitignore 模式
• 包括路径遍历保护在内的安全特性
• MIME 类型检测

安装

使用 UV：

uv add mcp-filesystem-python

使用

运行服务器：

uv run src/filesystem/server.py /path/to/directory

Claude 桌面集成

配置示例

Claude 桌面的配置示例可以在 examples 目录中找到：

• examples/claude_desktop_config.json：适用于 macOS/Linux 的示例
• examples/claude_desktop_config_windows.json：适用于 Windows 的示例

这些文件应放置于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %AppData%\Claude\claude_desktop_config.json

请确保：

1. 用实际路径替换示例中的路径
2. 对于 macOS/Linux 使用正斜杠 (/)，对于 Windows 使用反斜杠 (\\)
3. 使用绝对路径（而非相对路径）

开发

1. 克隆仓库
2. 创建虚拟环境并同步依赖项，uv sync

许可证

MIT