MCP文件系统Python服务

MCP文件系统Python服务是一个基于模型上下文协议(MCP)的服务,提供对指定目录中文件的只读安全访问。该服务通过MCP协议暴露文件资源,支持文件搜索功能,并具备安全防护措施,如路径遍历保护和MIME类型检测。

  • by mtunell
  • 更新于
在 GitHub 查看 mtunell/mcp-filesystem-python

使用说明

基本能力

产品定位

MCP文件系统Python服务是一个基于模型上下文协议(MCP)的服务,提供对指定目录中文件的只读安全访问。

核心功能

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

适用场景

  • 需要安全访问文件系统的应用
  • 需要集成文件搜索功能的应用
  • 需要遵循.gitignore模式的文件管理

工具列表

  • MCP工具:提供文件搜索能力

使用教程

使用依赖

无特别依赖,直接安装即可。

安装教程

使用UV安装:

uv add mcp-filesystem-python

运行服务

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

调试方式

无特别调试步骤,运行服务后即可使用。