MCP Server 能讓 Claude 直接連接資料庫、檔案系統或外部 API,實現真正的工具整合。本指南將帶你從環境準備到實際設定,完成第一個 MCP Server 部署。

什麼是 MCP?為何現在就該學?

Model Context Protocol(MCP)是 AI 工具整合的開放標準協議,2026年3月 SDK 下載量已突破 9700 萬次,活躍伺服器超過 10,000 個。Google Cloud 近期更推出 gRPC 傳輸套件,補足企業微服務架構需求。

MCP 被譽為 AI 應用的「USB-C 介面」——無論是 Claude、ChatGPT、Gemini 還是 GitHub Copilot,都透過同一標準協議連接外部系統。開發者可在本機或雲端架設 Server,實現資料庫查詢、檔案存取、API 呼叫等能力。

環境準備與前置需求

在開始架設 MCP Server 前,你需要準備以下環境:

  • Node.js 18+:MCP SDK 主要以 TypeScript/JavaScript 開發
  • Claude Desktop 應用程式:版本需為 1.0 以上
  • 基礎終端機操作能力:熟悉 npm/yarn 指令

確認方式:在終端機執行 node --versionnpm --version 確認版本編號。

快速架設第一個 MCP Server

以下以官方提供的 Filesystem Server 為例,示範如何讓 Claude 存取指定目錄:

# 建立專案目錄
mkdir my-mcp-server && cd my-mcp-server

# 初始化專案
npm init -y

# 安裝 MCP SDK
npm install @modelcontextprotocol/server-filesystem

# 建立 server.js
cat > server.js << 'EOF'
import { Server } from '@modelcontextprotocol/server';
import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
import { FileSystemServer } from '@modelcontextprotocol/server-filesystem';

const server = new Server(
  new FileSystemServer('/your/target/directory'),
  { name: 'my-filesystem-server', version: '1.0.0' }
);

const transport = new StdioServerTransport();
server.connect(transport);
EOF

此設定讓 Claude 能讀取指定目錄的檔案內容,完成基本的工具整合能力。

Claude Desktop 整合設定

架設 Server 後,需在 Claude Desktop 中註冊才能使用:

  1. 開啟 Claude Desktop,進入 Settings > Developer
  2. 點擊「Edit Config」開啟設定檔
  3. 加入以下設定:
{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["/absolute/path/to/server.js"],
      "env": {}
    }
  }
}

儲存後重啟 Claude Desktop,測試時可輸入「列出 /your/target/directory 的檔案」驗證整合是否成功。

常見問題與故障排除

  • Server 連線失敗:檢查路徑是否為絕對路徑,確認 node 版本是否為 18+
  • 權限不足:確認目標目錄讀取權限已開放
  • 企業環境部署:可使用 Docker 容器化 MCP Server,配合 gRPC 傳輸實現高可用架構

MCP 已從實驗性技術轉為生產就緒標準,掌握此協議將大幅提升 AI 助手的工作能力。