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 --version 與 npm --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 中註冊才能使用:
- 開啟 Claude Desktop,進入 Settings > Developer
- 點擊「Edit Config」開啟設定檔
- 加入以下設定:
{
"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 助手的工作能力。