Philgei MCP Server Filesystem

🚀 MCP 文件系統服務器

這是一個非官方的 Claude 文件系統 MCP 服務器實現端口，僅用於概念驗證（POC），與 Anthropic 無關，不可用於生產環境，主要用於演示和探索 MCP 服務器的功能。

🚀 快速開始

使用 UVX 進行安裝，具體步驟如下：

uv venv
.venv\Scripts\activate  # Windows 系統
uv pip install -e .

💻 使用示例

與 Claude Desktop 配合使用

1. 修改配置文件

修改 claude_desktop_config.json 文件，示例如下：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // 替換為你所需的目錄
      ]
    }
  }
}

若需要添加多個目錄，可參考以下配置：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/",
        "C:/Users/YourUsername/Documents",
        "~/Desktop"
      ]
    }
  }
}

2. 重啟應用

重啟 Claude Desktop 使更改生效。

3. 在 Claude Desktop 中操作

• 點擊紙clip 圖標。
• 選擇 MCP 菜單（兩個相連的插頭圖標）。
• 你的文件系統服務器將在集成選項中顯示。

⚠️ 安全注意

服務器僅允許訪問 args 數組中指定的目錄，會對路徑進行嚴格驗證，防止越權訪問。

🛠️ 故障排除

命令未找到

• 確保已安裝該包，可使用 uv pip list 進行檢查。
• 確認 Python 環境已激活。

訪問被拒絕

• 驗證 args 中的目錄是否存在。
• 確保你對指定目錄具有讀取權限。

服務器未顯示在 Claude Desktop 中

• 檢查配置文件語法是否正確。
• 在更改配置後重啟 Claude Desktop。