什麼是 Claude Desktop 與 MCP Server

Claude Desktop 是 Anthropic 公司推出的 AI 桌面應用程式，而 MCP Server（Model Context Protocol Server）是一個開源的伺服器解決方案，讓 Claude Desktop 能夠存取本地檔案系統、執行命令以及與各種開發工具整合。透過 MCP Server，您可以讓 AI 助手直接讀取專案檔案、執行開發指令，大幅提升開發效率。

簡單來說，MCP Server 就像是 Claude Desktop 與您電腦之間的橋樑，允許 AI 在您授權的範圍內操作本地資源。這種設計兼顧了便利性與安全性，是目前 AI 輔助開發的重要架構。

安裝前的環境準備

在開始安裝 MCP Server 之前，需要確保您的系統符合以下必要條件：

驗證 Node.js 安裝狀態，請在終端機輸入以下指令：

node --version
npm --version

確認版本號顯示後，即可進入下一階段的 MCP Server 安裝流程。

MCP Server 一鍵安裝教學

以下提供兩種主要的安裝方式，您可以根據需求選擇最適合的方法：

方式一：使用 npm 全域安裝（推薦）

這是最簡單的一鍵安裝方式，開啟終端機並執行以下指令：

npm install -g @modelcontextprotocol/server-filesystem

安裝完成後，您需要設定環境變數。請在 Claude Desktop 的設定檔案中添加以下內容：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/your/project/path"]
    }
  }
}

將/your/project/path替換為您想要讓 Claude 存取的本機目錄路徑。

方式二：使用 Docker 部署

若您偏好使用容器化方式，可透過 Docker 快速啟動 MCP Server：

docker run -d -p 3100:3100 \
  -v /your/project/path:/workspace \
  ghcr.io/modelcontextprotocol/server-filesystem:latest

Docker 方式的好處在於環境隔離，適合需要同時管理多個專案的開發者。

Claude Desktop 連接 MCP Server

安裝完成後，按照以下步驟建立 Claude Desktop 與 MCP Server 的連接：

  1. 開啟 Claude Desktop 應用程式
  2. 點擊左上角選單，選擇「Settings」或「設定」
  3. 進入「Developer」選項
  4. 點擊「Edit Config」編輯設定檔
  5. 確認config.json中已正確配置 MCP Server 資訊
  6. 儲存設定並重啟 Claude Desktop

重新啟動後，您可以嘗試輸入指令測試連接，例如要求 Claude 列出您授權目錄中的檔案。如果成功回應，表示 MCP Server 已正常運作。

常見問題與解決方案

在配置過程中，使用者可能會遇到以下常見問題，這裡提供具體的解決方案：

若遇到其他問題，可查看 Claude Desktop 官方文件或 GitHub 專案的 Issues 頁面尋求協助。