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 自动打开浏览器进行安全登录
- 完成认证后,后续连接自动处理
热门新增远程 MCP 服务器
GitHub MCP 服务器(2025年6月)
GitHub 官方推出了远程 MCP 服务器公共预览版:
特性:
- OAuth 2.0 认证:推荐的认证方式,支持作用域访问
- SAML 执行:企业级安全支持
- 自动更新:GitHub 托管服务器,自动应用更新
- 一键设置:无需本地安装或运行
Linear MCP 服务器
Linear 的 MCP 集成将项目管理直接引入 Claude Code:
功能:
- 实时上下文:从 Linear 获取结构化、实时的上下文
- 问题详情:Claude Code 可以提取问题详情和项目状态
- 工作流集成:在规划、编写代码和管理问题之间保持流畅
DigitalOcean MCP 服务器
DigitalOcean MCP 服务器连接 Claude Code 到您的 DigitalOcean 账户:
能力:
- 应用部署:直接部署应用
- 日志获取:获取服务日志
- 服务重启:重启服务
- 资源管理:管理云资源
用户增长和采用情况
- 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
来源:豆瓜网用户自行投稿发布,如果侵权,请联系站长删除 |