MCP Server Filesystem

🚀 MCP 文件系統服務器

本項目是一個未經官方認可的Claude文件系統MCP服務器實現的端口，僅作為概念驗證（POC）。它可用於演示和探索MCP服務器功能，但與Anthropic無關，請勿在生產環境中使用。

🚀 快速開始

使用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。

⚠️ 重要提示

這是一個未經官方認可的Claude文件系統MCP服務器實現的端口，僅作為概念驗證（POC），與Anthropic無關，請勿在生產環境中使用。