首页 › 智能体/知识库 › Claude Code MCP 快速高效使用指南

里雪 發表於 2025-7-9 21:22:00

Claude Code MCP 快速高效使用指南

<h1 id="claude-code-mcp-快速高效使用指南">Claude Code MCP 快速高效使用指南</h1>
<h2 id="概述">概述</h2>
<p>Model Context Protocol (MCP) 是一个开放协议，使大型语言模型能够访问外部工具和数据源。在 Claude Code 中，MCP 提供了标准化的方式来扩展 Claude 的功能，连接外部工具和服务。</p>
<h2 id="基本配置命令">基本配置命令</h2>
<h3 id="添加-mcp-服务器">添加 MCP 服务器</h3>
<p><strong>基本语法：</strong></p>
<pre><code class="language-bash">claude mcp add &lt;name&gt; &lt;command&gt;
</code></pre>
<p><strong>常用示例：</strong></p>
<pre><code class="language-bash"># 添加文件系统服务器
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
</code></pre>
<h3 id="服务器传输类型">服务器传输类型</h3>
<p><strong>SSE (Server-Sent Events)：</strong></p>
<pre><code class="language-bash">claude mcp add --transport sse sse-server https://example.com/sse-endpoint
</code></pre>
<p><strong>HTTP：</strong></p>
<pre><code class="language-bash">claude mcp add --transport http http-server https://example.com/mcp
</code></pre>
<h3 id="管理命令">管理命令</h3>
<pre><code class="language-bash"># 列出所有配置的服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get my-server

# 删除服务器
claude mcp remove my-server

# 重置项目选择
claude mcp reset-project-choices
</code></pre>
<h2 id="配置作用域">配置作用域</h2>
<ul>
<li><strong>local (默认)</strong>：仅在当前项目中可用</li>
<li><strong>project</strong>：通过 <code>.mcp.json</code> 文件与项目中的所有人共享</li>
<li><strong>user</strong>：在所有项目中可用</li>
</ul>
<h2 id="配置文件详解">配置文件详解</h2>
<h3 id="直接配置文件编辑">直接配置文件编辑</h3>
<p>配置存储在 <code>.claude.json</code> 文件中，包含 <code>mcpServers</code> 对象：</p>
<pre><code class="language-json">{
"mcpServers": {
    "sequential-thinking": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
}
}
</code></pre>
<h3 id="高级配置示例">高级配置示例</h3>
<p>包含环境变量和 API 密钥的复杂配置：</p>
<pre><code class="language-json">{
"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": ""
      }
    }
}
}
</code></pre>
<h2 id="2025-年新特性与6-7月最新更新">2025 年新特性与6-7月最新更新</h2>
<h3 id="远程服务器支持2025年7月重大更新">远程服务器支持（2025年7月重大更新）</h3>
<p>Claude Code 现已正式支持远程 MCP 服务器，这是从之前仅支持本地服务器的重大升级：</p>
<p><strong>核心优势：</strong></p>
<ul>
<li><strong>低维护成本</strong>：只需将供应商的 URL 添加到 Claude Code - 无需手动设置</li>
<li><strong>自动更新</strong>：供应商负责更新、扩展和可用性管理</li>
<li><strong>专注开发</strong>：开发者可以专注于构建，而不是管理服务器基础设施</li>
</ul>
<p><strong>配置示例：</strong></p>
<pre><code class="language-bash"># 添加远程 MCP 服务器
claude mcp add --transport sse remote-server https://vendor.com/mcp-endpoint
</code></pre>
<h3 id="oauth-认证集成2025年6月">OAuth 认证集成（2025年6月）</h3>
<p>Claude Code 现在提供原生的 OAuth 支持，显著改善了安全性和用户体验：</p>
<p><strong>特性：</strong></p>
<ul>
<li><strong>一次认证</strong>：只需认证一次，Claude Code 自动处理后续连接</li>
<li><strong>无需管理 API 密钥</strong>：OAuth 流程自动处理身份验证</li>
<li><strong>安全连接</strong>：与现有账户的安全连接</li>
<li><strong>SAML 执行</strong>：支持企业级身份验证</li>
</ul>
<p><strong>使用流程：</strong></p>
<ol>
<li>添加支持 OAuth 的 MCP 服务器</li>
<li>Claude Code 自动打开浏览器进行安全登录</li>
<li>完成认证后，后续连接自动处理</li>
</ol>
<h3 id="热门新增远程-mcp-服务器">热门新增远程 MCP 服务器</h3>
<h4 id="github-mcp-服务器2025年6月">GitHub MCP 服务器（2025年6月）</h4>
<p>GitHub 官方推出了远程 MCP 服务器公共预览版：</p>
<p><strong>特性：</strong></p>
<ul>
<li><strong>OAuth 2.0 认证</strong>：推荐的认证方式，支持作用域访问</li>
<li><strong>SAML 执行</strong>：企业级安全支持</li>
<li><strong>自动更新</strong>：GitHub 托管服务器，自动应用更新</li>
<li><strong>一键设置</strong>：无需本地安装或运行</li>
</ul>
<h4 id="linear-mcp-服务器">Linear MCP 服务器</h4>
<p>Linear 的 MCP 集成将项目管理直接引入 Claude Code：</p>
<p><strong>功能：</strong></p>
<ul>
<li><strong>实时上下文</strong>：从 Linear 获取结构化、实时的上下文</li>
<li><strong>问题详情</strong>：Claude Code 可以提取问题详情和项目状态</li>
<li><strong>工作流集成</strong>：在规划、编写代码和管理问题之间保持流畅</li>
</ul>
<h4 id="digitalocean-mcp-服务器">DigitalOcean MCP 服务器</h4>
<p>DigitalOcean MCP 服务器连接 Claude Code 到您的 DigitalOcean 账户：</p>
<p><strong>能力：</strong></p>
<ul>
<li><strong>应用部署</strong>：直接部署应用</li>
<li><strong>日志获取</strong>：获取服务日志</li>
<li><strong>服务重启</strong>：重启服务</li>
<li><strong>资源管理</strong>：管理云资源</li>
</ul>
<h3 id="用户增长和采用情况">用户增长和采用情况</h3>
<ul>
<li>Claude Code 的活跃用户基数在 Claude 4 模型发布后三个月内增长了 160%</li>
<li>远程 MCP 服务器支持显著简化了外部工具和服务的集成</li>
<li>开发者不再需要管理本地服务器基础设施的复杂性</li>
</ul>
<h3 id="技术改进">技术改进</h3>
<h4 id="增强的连接性">增强的连接性</h4>
<ul>
<li><strong>HTTP + Server-Sent Events (SSE)</strong>：改进的性能和可靠性</li>
<li><strong>实时通信</strong>：支持实时数据流</li>
<li><strong>自动重连</strong>：网络中断时自动重新连接</li>
</ul>
<h4 id="安全性增强">安全性增强</h4>
<ul>
<li><strong>OAuth 2.0 标准</strong>：使用业界标准的身份验证</li>
<li><strong>作用域访问</strong>：精确控制访问权限</li>
<li><strong>企业级支持</strong>：SAML 执行和企业身份提供商集成</li>
</ul>
<h3 id="增强的传输协议">增强的传输协议</h3>
<ul>
<li>改进的性能和可靠性</li>
<li>实时通信支持</li>
<li>流式 JSON 输出</li>
</ul>
<h2 id="2025年最受欢迎的top-10-mcp服务器">2025年最受欢迎的Top 10 MCP服务器</h2>
<p>根据开发者使用情况和社区评价，以下是2025年最受欢迎的Claude Code MCP服务器：</p>
<h3 id="1-github-mcp-server-">1. GitHub MCP Server 🥇</h3>
<p>连接 Claude Code 到 GitHub 的 REST API，实现与仓库的无缝交互。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>读取问题、管理PR、触发CI/CD工作流</li>
<li>分析提交历史，代码审查</li>
<li>支持OAuth认证，安全可靠</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github
</code></pre>
<h3 id="2-browser-tools-mcp-server-">2. Browser Tools MCP Server 🥈</h3>
<p>通过自然语言控制和自动化浏览器操作。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>网页导航、表单填充、数据抓取</li>
<li>支持Puppeteer和Playwright</li>
<li>适用于Web开发和测试</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer
claude mcp add playwright npx @playwright/mcp@latest
</code></pre>
<h3 id="3-file-system-mcp-server-">3. File System MCP Server 🥉</h3>
<p>管理本地文件，让 Claude Code 读写编辑本机文件。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>项目管理、日志分析、快速编辑</li>
<li>精确的目录权限控制</li>
<li>安全的文件访问机制</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects
</code></pre>
<h3 id="4-apidog-mcp-server">4. Apidog MCP Server</h3>
<p>简化API开发，集成API文档、测试和代码生成。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>查询API规范、测试端点</li>
<li>生成客户端代码</li>
<li>一站式API开发环境</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add apidog -s user -- npx -y @apidog/mcp-server
</code></pre>
<h3 id="5-sequential-thinking-mcp-server">5. Sequential Thinking MCP Server</h3>
<p>增强问题解决能力，将复杂任务分解为逻辑步骤。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>多阶段规划和架构设计</li>
<li>系统分解和大规模重构</li>
<li>逻辑推理增强</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add sequential-thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking
</code></pre>
<h3 id="6-postgresql-mcp-server">6. PostgreSQL MCP Server</h3>
<p>通过自然语言查询数据库。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>直接数据库交互</li>
<li>自然语言SQL查询</li>
<li>数据分析和报表生成</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add postgres -s user -- env DATABASE_URL=your_db_url npx -y @modelcontextprotocol/server-postgres
</code></pre>
<h3 id="7-notion-mcp-server">7. Notion MCP Server</h3>
<p>从 Claude 直接更新 Notion 知识库。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>内部知识库管理</li>
<li>页面创建和更新</li>
<li>团队协作增强</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add notion -s user -- env NOTION_TOKEN=your_token npx -y @modelcontextprotocol/server-notion
</code></pre>
<h3 id="8-memory-bank-mcp-server">8. Memory Bank MCP Server</h3>
<p>为AI代理提供跨会话的上下文记忆。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>集中式记忆系统</li>
<li>大型代码库导航</li>
<li>项目级理解维护</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add memory-bank -s user -- npx -y @modelcontextprotocol/server-memory-bank
</code></pre>
<h3 id="9-zapier-mcp-server">9. Zapier MCP Server</h3>
<p>自动化跨应用工作流程。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>连接数千个应用</li>
<li>工作流自动化</li>
<li>安全的跨应用交互</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add zapier -s user -- env ZAPIER_API_KEY=your_key npx -y @modelcontextprotocol/server-zapier
</code></pre>
<h3 id="10-docker-mcp-server">10. Docker MCP Server</h3>
<p>在容器中安全执行代码操作。</p>
<p><strong>功能特点：</strong></p>
<ul>
<li>隔离的执行环境</li>
<li>安全的代码执行</li>
<li>AI开发工作流增强</li>
</ul>
<p><strong>安装：</strong></p>
<pre><code class="language-bash">claude mcp add docker -s user -- npx -y @modelcontextprotocol/server-docker
</code></pre>
<h2 id="选择mcp服务器的建议">选择MCP服务器的建议</h2>
<h3 id="开发者必备组合">开发者必备组合</h3>
<ul>
<li><strong>GitHub + File System + Sequential Thinking</strong>：适合代码开发和版本控制</li>
<li><strong>Browser Tools + Apidog + Memory Bank</strong>：适合Web开发和API测试</li>
<li><strong>PostgreSQL + Notion + Zapier</strong>：适合数据驱动的项目管理</li>
</ul>
<h3 id="安全性考虑">安全性考虑</h3>
<ul>
<li>使用用户级别安装 (<code>-s user</code>) 确保权限控制</li>
<li>定期更新MCP服务器以获得最新安全补丁</li>
<li>谨慎配置文件系统和数据库访问权限</li>
</ul>
<h2 id="常用-mcp-服务器传统配置">常用 MCP 服务器（传统配置）</h2>
<h3 id="文件系统服务器">文件系统服务器</h3>
<pre><code class="language-bash">claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects
</code></pre>
<h3 id="github-集成">GitHub 集成</h3>
<pre><code class="language-bash">claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github
</code></pre>
<h3 id="浏览器自动化">浏览器自动化</h3>
<pre><code class="language-bash">claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer
claude mcp add playwright npx @playwright/mcp@latest
</code></pre>
<h3 id="搜索工具">搜索工具</h3>
<pre><code class="language-bash">claude mcp add fetch -s user -- npx -y @kazuph/mcp-fetch
</code></pre>
<h2 id="最佳实践2025年更新版">最佳实践（2025年更新版）</h2>
<h3 id="1-配置管理">1. 配置管理</h3>
<ul>
<li><strong>优先使用远程服务器</strong>：减少本地维护负担，享受自动更新</li>
<li><strong>OAuth 认证优先</strong>：使用 OAuth 替代 API 密钥管理</li>
<li>使用直接配置文件编辑获得更好的控制和灵活性</li>
<li>遵循配置作用域层次结构：本地 &gt; 项目 &gt; 用户</li>
<li>将项目特定的配置存储在 <code>.mcp.json</code> 文件中以便团队共享</li>
</ul>
<h3 id="2-服务器选择策略">2. 服务器选择策略</h3>
<ul>
<li><strong>本地服务器</strong>：适合开发和测试环境，完全控制</li>
<li><strong>远程服务器</strong>：适合生产环境和团队协作，低维护</li>
<li><strong>混合使用</strong>：根据具体需求选择合适的服务器类型</li>
</ul>
<h3 id="3-安全性最佳实践">3. 安全性最佳实践</h3>
<ul>
<li><strong>OAuth 2.0 优先</strong>：更安全、更便于管理</li>
<li><strong>SAML 企业集成</strong>：确保合规性和企业级安全</li>
<li><strong>权限最小化</strong>：仅授予必要的访问权限</li>
<li><strong>定期审查</strong>：定期检查和更新服务器配置</li>
</ul>
<h3 id="4-环境变量管理">4. 环境变量管理</h3>
<ul>
<li>使用 <code>-e</code> 或 <code>--env</code> 标志设置环境变量</li>
<li>配置 MCP 服务器启动超时：<code>MCP_TIMEOUT=10000 claude</code></li>
<li>将敏感信息存储在环境变量中，而非配置文件</li>
</ul>
<h3 id="5-上下文管理">5. 上下文管理</h3>
<ul>
<li>有效管理上下文是充分利用 Claude Code 的关键</li>
<li>注意上下文左侧指示器和 Claude 自动压缩较旧部分的时机</li>
<li>在工作流程的自然断点处主动压缩</li>
</ul>
<h3 id="6-自定义斜杠命令">6. 自定义斜杠命令</h3>
<ul>
<li>将重复的工作流程存储在 <code>.claude/commands</code> 文件夹中的 Markdown 文件中</li>
<li>这些命令可通过斜杠命令菜单访问</li>
<li>可以提交到 git 中供团队共享</li>
</ul>
<h3 id="7-监控和维护">7. 监控和维护</h3>
<ul>
<li><strong>远程服务器优势</strong>：自动更新和维护</li>
<li><strong>状态监控</strong>：使用 <code>claude mcp list</code> 检查服务器状态</li>
<li><strong>OAuth 令牌</strong>：监控认证状态和令牌有效性</li>
</ul>
<h2 id="调试和监控">调试和监控</h2>
<h3 id="调试模式">调试模式</h3>
<pre><code class="language-bash">claude --mcp-debug
</code></pre>
<h3 id="检查-mcp-状态">检查 MCP 状态</h3>
<pre><code class="language-bash">/mcp
</code></pre>
<p>显示每个 MCP 服务器的连接状态（"connected" 或 "failed"）</p>
<h3 id="头部模式自动化">头部模式自动化</h3>
<pre><code class="language-bash">claude -p "your prompt" --output-format stream-json
</code></pre>
<h2 id="实际应用场景">实际应用场景</h2>
<h3 id="1-视觉开发工作流">1. 视觉开发工作流</h3>
<ul>
<li>使用浏览器截图（通过 Puppeteer MCP 服务器）</li>
<li>提供视觉模型，让 Claude 实现设计</li>
<li>截图并迭代直到结果匹配模型</li>
</ul>
<h3 id="2-数据库集成">2. 数据库集成</h3>
<ul>
<li>使用数据库 MCP 服务器（如 Postgres）</li>
<li>让 Claude Code 直接与数据库交互进行查询和数据分析</li>
</ul>
<h3 id="3-自动化工作流">3. 自动化工作流</h3>
<ul>
<li>在 CI、pre-commit 钩子和自动化中使用头部模式</li>
<li>流式 JSON 输出用于程序化处理</li>
</ul>
<h2 id="资源访问">资源访问</h2>
<h3 id="使用资源">使用资源</h3>
<ul>
<li>在提示中输入 <code>@</code> 查看所有连接的 MCP 服务器的可用资源</li>
<li>资源与文件一起出现在自动完成菜单中</li>
</ul>
<h3 id="社区资源">社区资源</h3>
<ul>
<li>访问 mcp.so 和 smithery.ai 探索更多 MCP 服务器</li>
<li>查看 Claude MCP 社区 (claudemcp.com) 获取最新服务器</li>
</ul>
<h2 id="故障排除">故障排除</h2>
<h3 id="常见问题">常见问题</h3>
<ol>
<li><strong>服务器连接失败</strong>：检查命令路径和参数</li>
<li><strong>环境变量未设置</strong>：确保 API 密钥正确配置</li>
<li><strong>权限问题</strong>：检查文件系统权限和网络访问</li>
</ol>
<h3 id="解决方案">解决方案</h3>
<ul>
<li>使用 <code>--mcp-debug</code> 标志识别配置问题</li>
<li>检查 <code>.claude.json</code> 文件语法</li>
<li>验证网络连接和 API 密钥有效性</li>
</ul>
<h2 id="总结">总结</h2>
<p>Claude Code MCP 在 2025 年为开发者提供了强大的扩展能力，通过标准化协议连接外部工具和服务。正确配置和使用 MCP 服务器可以显著提高开发效率和 Claude 的功能范围。</p>
<p>记住关键原则：</p>
<ul>
<li>选择合适的配置作用域</li>
<li>安全管理 API 密钥</li>
<li>有效利用上下文管理</li>
<li>善用社区资源和最佳实践</li>
</ul>
<p>通过遵循本指南，你可以快速高效地在 Claude Code 中使用 MCP，充分发挥其潜力。</p><br><br>
来源：https://www.cnblogs.com/lf109/p/18975750

查看完整版本: Claude Code MCP 快速高效使用指南