2025年7月10日

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，充分发挥其潜力。

一	二	三	四	五	六	日
« 6月
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

六狼博客

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. 自动化工作流

资源访问

使用资源

社区资源

故障排除

常见问题

解决方案

总结