MCP Filesystem Python
2025.01.05
9
文件管理系统文件访问服务文件管理
MCP Filesystem Python 是一个基于 Model Context Protocol (MCP) 的服务，提供对指定目录中文件的只读访问。它具有安全特性，包括路径遍历保护和 MIME 类型检测，同时支持文件搜索功能。
View on GitHub
Overview
基本能力
产品定位
MCP Filesystem Python 是一个文件管理系统，提供对指定目录中文件的只读访问。
核心功能
- 使用
file://URI 方案将文件暴露为 MCP 资源 - 通过 MCP 工具提供文件搜索功能
- 尊重 .gitignore 模式
- 安全特性，包括路径遍历保护
- MIME 类型检测
适用场景
- 需要安全访问文件系统的场景
- 需要文件搜索功能的场景
- 需要集成到 Claude Desktop 的场景
工具列表
- 文件搜索工具：提供文件搜索能力
常见问题解答
- 如何配置 Claude Desktop 集成？参考
examples目录中的示例配置文件 - 路径格式要求：macOS/Linux 使用正斜杠，Windows 使用反斜杠
- 必须使用绝对路径
使用教程
使用依赖
需要安装 UV 工具。
安装教程
使用 UV 安装：
uv add mcp-filesystem-python
运行服务器
uv run src/filesystem/server.py /path/to/directory
调试方式
- 克隆仓库
- 创建虚拟环境并同步需求：
uv sync