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 Desktop 集成

配置示例

Claude Desktop 的配置示例可以在 `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