Filesystem (Python)

🚀 MCP 文件系統 Python

MCP 文件系統 Python 是一個基於 Model Context Protocol (MCP) 的服務器，它為特定目錄中的文件提供安全的只讀訪問，能有效解決文件安全訪問及搜索的問題，為用戶提供便捷、安全的文件操作體驗。

🚀 快速開始

MCP 文件系統 Python 可使用 UV 進行安裝，安裝完成後即可運行服務器開啟使用。

✨ 主要特性

• 使用 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 許可證。