Stories

Detail

Return

Claude Code MCP 快速高效使用指南 - Stories Detail

04:35 AM · Nov 07 ,2025

Claude Code MCP 快速高效使用指南

概述

Model Context Protocol (MCP) 是一個開放協議，使大型語言模型能夠訪問外部工具和數據源。在 Claude Code 中，MCP 提供了標準化的方式來擴展 Claude 的功能，連接外部工具和服務。

基本配置命令

添加 MCP 服務器

基本語法：

claude mcp add <name> <command> [args...]

常用示例：

# 添加文件系統服務器
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

# 添加 GitHub 服務器
claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github

# 添加 Puppeteer 服務器
claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

# 添加 Playwright 服務器
claude mcp add playwright npx @playwright/mcp@latest

服務器傳輸類型

SSE (Server-Sent Events)：

claude mcp add --transport sse sse-server https://example.com/sse-endpoint

HTTP：

claude mcp add --transport http http-server https://example.com/mcp

管理命令

# 列出所有配置的服務器
claude mcp list

# 獲取特定服務器的詳細信息
claude mcp get my-server

# 刪除服務器
claude mcp remove my-server

# 重置項目選擇
claude mcp reset-project-choices

配置作用域

local (默認)：僅在當前項目中可用
project：通過 .mcp.json 文件與項目中的所有人共享
user：在所有項目中可用

配置文件詳解

直接配置文件編輯

配置存儲在 .claude.json 文件中，包含 mcpServers 對象：

{
  "mcpServers": {
    "sequential-thinking": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}

高級配置示例

包含環境變量和 API 密鑰的複雜配置：

{
  "mcpServers": {
    "mcp-omnisearch": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-omnisearch"],
      "env": {
        "TAVILY_API_KEY": "",
        "BRAVE_API_KEY": "",
        "KAGI_API_KEY": "",
        "PERPLEXITY_API_KEY": "",
        "JINA_AI_API_KEY": ""
      }
    }
  }
}

2025 年新特性與6-7月最新更新

遠程服務器支持（2025年7月重大更新）

Claude Code 現已正式支持遠程 MCP 服務器，這是從之前僅支持本地服務器的重大升級：

核心優勢：

低維護成本：只需將供應商的 URL 添加到 Claude Code - 無需手動設置
自動更新：供應商負責更新、擴展和可用性管理
專注開發：開發者可以專注於構建，而不是管理服務器基礎設施

配置示例：

# 添加遠程 MCP 服務器
claude mcp add --transport sse remote-server https://vendor.com/mcp-endpoint

OAuth 認證集成（2025年6月）

Claude Code 現在提供原生的 OAuth 支持，顯著改善了安全性和用户體驗：

特性：

一次認證：只需認證一次，Claude Code 自動處理後續連接
無需管理 API 密鑰：OAuth 流程自動處理身份驗證
安全連接：與現有賬户的安全連接
SAML 執行：支持企業級身份驗證

使用流程：

添加支持 OAuth 的 MCP 服務器
Claude Code 自動打開瀏覽器進行安全登錄
完成認證後，後續連接自動處理

用户增長和採用情況

Claude Code 的活躍用户基數在 Claude 4 模型發佈後三個月內增長了 160%
遠程 MCP 服務器支持顯著簡化了外部工具和服務的集成
開發者不再需要管理本地服務器基礎設施的複雜性

技術改進

增強的連接性

HTTP + Server-Sent Events (SSE)：改進的性能和可靠性
實時通信：支持實時數據流
自動重連：網絡中斷時自動重新連接

安全性增強

OAuth 2.0 標準：使用業界標準的身份驗證
作用域訪問：精確控制訪問權限
企業級支持：SAML 執行和企業身份提供商集成

增強的傳輸協議

改進的性能和可靠性
實時通信支持
流式 JSON 輸出

2025年最受歡迎的Top 10 MCP服務器

根據開發者使用情況和社區評價，以下是2025年最受歡迎的Claude Code MCP服務器：

1. GitHub MCP Server 🥇

連接 Claude Code 到 GitHub 的 REST API，實現與倉庫的無縫交互。

功能特點：

讀取問題、管理PR、觸發CI/CD工作流
分析提交歷史，代碼審查
支持OAuth認證，安全可靠

安裝：

claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github

2. Browser Tools MCP Server 🥈

通過自然語言控制和自動化瀏覽器操作。

功能特點：

網頁導航、表單填充、數據抓取
支持Puppeteer和Playwright
適用於Web開發和測試

安裝：

claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer
claude mcp add playwright npx @playwright/mcp@latest

3. File System MCP Server 🥉

管理本地文件，讓 Claude Code 讀寫編輯本機文件。

功能特點：

項目管理、日誌分析、快速編輯
精確的目錄權限控制
安全的文件訪問機制

安裝：

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

4. Apidog MCP Server

簡化API開發，集成API文檔、測試和代碼生成。

功能特點：

查詢API規範、測試端點
生成客户端代碼
一站式API開發環境

安裝：

claude mcp add apidog -s user -- npx -y @apidog/mcp-server

5. Sequential Thinking MCP Server

增強問題解決能力，將複雜任務分解為邏輯步驟。

功能特點：

多階段規劃和架構設計
系統分解和大規模重構
邏輯推理增強

安裝：

claude mcp add sequential-thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking

6. PostgreSQL MCP Server

通過自然語言查詢數據庫。

功能特點：

直接數據庫交互
自然語言SQL查詢
數據分析和報表生成

安裝：

claude mcp add postgres -s user -- env DATABASE_URL=your_db_url npx -y @modelcontextprotocol/server-postgres

7. Notion MCP Server

從 Claude 直接更新 Notion 知識庫。

功能特點：

內部知識庫管理
頁面創建和更新
團隊協作增強

安裝：

claude mcp add notion -s user -- env NOTION_TOKEN=your_token npx -y @modelcontextprotocol/server-notion

8. Memory Bank MCP Server

為AI代理提供跨會話的上下文記憶。

功能特點：

集中式記憶系統
大型代碼庫導航
項目級理解維護

安裝：

claude mcp add memory-bank -s user -- npx -y @modelcontextprotocol/server-memory-bank

9. Zapier MCP Server

自動化跨應用工作流程。

功能特點：

連接數千個應用
工作流自動化
安全的跨應用交互

安裝：

claude mcp add zapier -s user -- env ZAPIER_API_KEY=your_key npx -y @modelcontextprotocol/server-zapier

10. Docker MCP Server

在容器中安全執行代碼操作。

功能特點：

隔離的執行環境
安全的代碼執行
AI開發工作流增強

安裝：

claude mcp add docker -s user -- npx -y @modelcontextprotocol/server-docker

選擇MCP服務器的建議

開發者必備組合

GitHub + File System + Sequential Thinking：適合代碼開發和版本控制
Browser Tools + Apidog + Memory Bank：適合Web開發和API測試
PostgreSQL + Notion + Zapier：適合數據驅動的項目管理

安全性考慮

使用用户級別安裝 (-s user) 確保權限控制
定期更新MCP服務器以獲得最新安全補丁
謹慎配置文件系統和數據庫訪問權限

常用 MCP 服務器（傳統配置）

文件系統服務器

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

GitHub 集成

claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github

瀏覽器自動化

claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer
claude mcp add playwright npx @playwright/mcp@latest

搜索工具

claude mcp add fetch -s user -- npx -y @kazuph/mcp-fetch

最佳實踐（2025年更新版）

1. 配置管理

優先使用遠程服務器：減少本地維護負擔，享受自動更新
OAuth 認證優先：使用 OAuth 替代 API 密鑰管理
使用直接配置文件編輯獲得更好的控制和靈活性
遵循配置作用域層次結構：本地 > 項目 > 用户
將項目特定的配置存儲在 .mcp.json 文件中以便團隊共享

2. 服務器選擇策略

本地服務器：適合開發和測試環境，完全控制
遠程服務器：適合生產環境和團隊協作，低維護
混合使用：根據具體需求選擇合適的服務器類型

3. 安全性最佳實踐

OAuth 2.0 優先：更安全、更便於管理
SAML 企業集成：確保合規性和企業級安全
權限最小化：僅授予必要的訪問權限
定期審查：定期檢查和更新服務器配置

4. 環境變量管理

使用 -e 或 --env 標誌設置環境變量
配置 MCP 服務器啓動超時：MCP_TIMEOUT=10000 claude
將敏感信息存儲在環境變量中，而非配置文件

5. 上下文管理

有效管理上下文是充分利用 Claude Code 的關鍵
注意上下文左側指示器和 Claude 自動壓縮較舊部分的時機
在工作流程的自然斷點處主動壓縮

6. 自定義斜槓命令

將重複的工作流程存儲在 .claude/commands 文件夾中的 Markdown 文件中
這些命令可通過斜槓命令菜單訪問
可以提交到 git 中供團隊共享

7. 監控和維護

遠程服務器優勢：自動更新和維護
狀態監控：使用 claude mcp list 檢查服務器狀態
OAuth 令牌：監控認證狀態和令牌有效性

調試和監控

調試模式

claude --mcp-debug

檢查 MCP 狀態

/mcp

顯示每個 MCP 服務器的連接狀態（"connected" 或 "failed"）

頭部模式自動化

claude -p "your prompt" --output-format stream-json

實際應用場景

1. 視覺開發工作流

使用瀏覽器截圖（通過 Puppeteer MCP 服務器）
提供視覺模型，讓 Claude 實現設計
截圖並迭代直到結果匹配模型

2. 數據庫集成

使用數據庫 MCP 服務器（如 Postgres）
讓 Claude Code 直接與數據庫交互進行查詢和數據分析

3. 自動化工作流

在 CI、pre-commit 鈎子和自動化中使用頭部模式
流式 JSON 輸出用於程序化處理

資源訪問

使用資源

在提示中輸入 @ 查看所有連接的 MCP 服務器的可用資源
資源與文件一起出現在自動完成菜單中

社區資源

訪問 mcp.so 和 smithery.ai 探索更多 MCP 服務器
查看 Claude MCP 社區 (claudemcp.com) 獲取最新服務器

故障排除

常見問題

服務器連接失敗：檢查命令路徑和參數
環境變量未設置：確保 API 密鑰正確配置
權限問題：檢查文件系統權限和網絡訪問

解決方案

使用 --mcp-debug 標誌識別配置問題
檢查 .claude.json 文件語法
驗證網絡連接和 API 密鑰有效性

總結

Claude Code MCP 在 2025 年為開發者提供了強大的擴展能力，通過標準化協議連接外部工具和服務。正確配置和使用 MCP 服務器可以顯著提高開發效率和 Claude 的功能範圍。

記住關鍵原則：

選擇合適的配置作用域
安全管理 API 密鑰
有效利用上下文管理
善用社區資源和最佳實踐

通過遵循本指南，你可以快速高效地在 Claude Code 中使用 MCP，充分發揮其潛力。

mcp , AI

Nickey103 Blog

@lf109

Tags

AI (54)

mcp (22)

Stories

Claude Code MCP 快速高效使用指南 - Stories Detail

Claude Code MCP 快速高效使用指南

概述

基本配置命令

添加 MCP 服務器

服務器傳輸類型

管理命令

配置作用域

配置文件詳解

直接配置文件編輯

高級配置示例

2025 年新特性與6-7月最新更新

遠程服務器支持（2025年7月重大更新）

OAuth 認證集成（2025年6月）

熱門新增遠程 MCP 服務器

GitHub MCP 服務器（2025年6月）

Linear MCP 服務器

DigitalOcean MCP 服務器

用户增長和採用情況

技術改進

增強的連接性

安全性增強

增強的傳輸協議

2025年最受歡迎的Top 10 MCP服務器

1. GitHub MCP Server 🥇

2. Browser Tools MCP Server 🥈

3. File System MCP Server 🥉

4. Apidog MCP Server

5. Sequential Thinking MCP Server

6. PostgreSQL MCP Server

7. Notion MCP Server

8. Memory Bank MCP Server

9. Zapier MCP Server

10. Docker MCP Server

選擇MCP服務器的建議

開發者必備組合

安全性考慮

常用 MCP 服務器（傳統配置）

文件系統服務器

GitHub 集成

瀏覽器自動化

搜索工具

最佳實踐（2025年更新版）

1. 配置管理

2. 服務器選擇策略

3. 安全性最佳實踐

4. 環境變量管理

5. 上下文管理

6. 自定義斜槓命令

7. 監控和維護

調試和監控

調試模式

檢查 MCP 狀態

頭部模式自動化

實際應用場景

1. 視覺開發工作流

2. 數據庫集成

3. 自動化工作流

資源訪問

使用資源

社區資源

故障排除

常見問題

解決方案

總結

Add a new Comments