環(huán)境準(zhǔn)備

1. 系統(tǒng)要求

操作系統(tǒng)：Windows 10/11 或 macOS 10.15+（暫不支持Linux）

硬件配置：雙核CPU、8GB內(nèi)存、2GB存儲(chǔ)空間

軟件依賴：

Claude Desktop（最新版，作為MCP宿主應(yīng)用）

Node.js v18+（建議LTS版本，用于運(yùn)行JavaScript/TypeScript服務(wù)）

Python 3.10+（需添加到PATH，用于Python版服務(wù)）

UV（Python包管理器，替代pip）

Git（版本控制工具）

2. 依賴安裝（Windows示例）

powershell

復(fù)制

# 安裝包管理器 winget install --id astral-sh.uv -e winget install git.git sqlite.sqlite # 安裝Node.js服務(wù) npm install -g @
modelcontextprotocol/server-filesystem @
modelcontextprotocol/server-sqlite # 安裝Python服務(wù) uvx mcp-server-sqlite

創(chuàng)建MCP Server

基礎(chǔ)Python服務(wù)示例

復(fù)制

# server_demo.pyfrom mcp.server.fastmcp import FastMCPmcp = FastMCP('本地計(jì)算服務(wù)')@mcp.tool()def calculate(expression: str) -> float:    '''計(jì)算四則運(yùn)算表達(dá)式'''    return eval(expression)  # 實(shí)際部署需替換安全計(jì)算邏輯if __name__ == '__main__':    mcp.run(transport='stdio')

高級(jí)服務(wù)類型（通過npm安裝）

復(fù)制

# 文件系統(tǒng)服務(wù)npm install -g @modelcontextprotocol/server-filesystem # 數(shù)據(jù)庫(kù)服務(wù)npm install -g @modelcontextprotocol/server-sqlite# 網(wǎng)絡(luò)服務(wù)npm install -g @modelcontextprotocol/server-brave-search

配置MCP Client

1. 客戶端配置（以Claude為例）
   編輯配置文件claude_desktop_config.json：

json

復(fù)制

{ 'mcpservers': { '本地計(jì)算服務(wù)': { 'command': 'python', 'args': ['C:/path/to/server_demo.py'], 'env': {'PYTHONPATH': 'C:/Python310'} }, '文件服務(wù)': { 'command': 'npx', 'args': ['-y', '@
modelcontextprotocol/server-filesystem', 'C:/data'] } } }

2. 啟動(dòng)參數(shù)說明
3. stdio模式：通過標(biāo)準(zhǔn)輸入輸出通信，需指定本地解釋器路徑
4. sse模式：通過HTTP通信（當(dāng)前僅實(shí)驗(yàn)性支持）
5. 關(guān)鍵參數(shù)：--db-path：指定SQLite數(shù)據(jù)庫(kù)路徑--api-key：需要認(rèn)證服務(wù)的密鑰--log-level：設(shè)置調(diào)試日志級(jí)別

部署流程

1. 啟動(dòng)服務(wù)

bash

復(fù)制

# Python服務(wù) uv venv .venv source .venv/bin/activate python server_demo.py # Node.js服務(wù) npx @
modelcontextprotocol/server-filesystem C:/data

2. 客戶端連接驗(yàn)證

python

復(fù)制

# client_demo.py from mcp.client.stdio import stdio_client async with stdio_client(command='python', args=['server_demo.py']) as (read, write): async with ClientSession(read, write) as session: tools = await session.list_tools() print(f'可用工具: {tools}')

擴(kuò)展部署

1. 多服務(wù)集成

json

復(fù)制

{ 'mcpservers': { 'github': { 'command': 'npx', 'args': ['@
modelcontextprotocol/server-github'], 'env': {'GITHUB_TOKEN': 'ghp_xxx'} }, '瀏覽器自動(dòng)化': { 'command': 'npx', 'args': ['@
modelcontextprotocol/server-puppeteer'] } } }

2. 安全增強(qiáng)

使用uv secret管理敏感數(shù)據(jù)

啟用TLS加密通信（需配置SSL證書）

設(shè)置IP白名單（僅限localhost訪問）

故障排查

1. 常見問題

服務(wù)未啟動(dòng)：檢查進(jìn)程是否存活ps aux | grep mcp

依賴缺失：運(yùn)行uv pip check驗(yàn)證Python依賴

路徑錯(cuò)誤：Windows需使用雙反斜杠C:\\path\\to\\server

2. 調(diào)試工具

bash

復(fù)制

# 查看服務(wù)日志 uvx mcp-server-sqlite --log-level debug # 網(wǎng)絡(luò)診斷 curl
http://localhost:8080/healthz