Filesystem (Python)

🚀 MCP 文件系统 Python

MCP 文件系统 Python 是一个 Model Context Protocol (MCP) 服务器，它能为特定目录中的文件提供安全的只读访问服务，有效解决了文件安全访问和资源管理的问题。

🚀 快速开始

MCP 文件系统 Python 提供了便捷的安装和使用方式，让你能迅速部署并使用该服务。

✨ 主要特性

• 使用 file:// URI 方案将文件作为 MCP 资源暴露，方便资源的统一管理和访问。
• 提供通过 MCP 工具进行文件搜索的功能，提升文件查找效率。
• 尊重 .gitignore 模式，避免不必要的文件暴露。
• 具备路径遍历防护等安全功能，保障文件访问的安全性。
• 支持 MIME 类型检测，更好地处理不同类型的文件。

📦 安装指南

使用 UV 进行安装，执行以下命令：

uv add mcp-filesystem-python

💻 使用示例

基础用法

运行服务器，指定要访问的目录路径：

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

📚 详细文档

与 Claude 桌面集成

配置示例

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

• 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 许可证。