⚡

MCP服务器配置Skill mcp-setup

该技能用于配置模型上下文协议 (MCP) 服务器，以扩展 Claude Code AI 智能体的能力，集成外部工具如网络搜索、文件系统和 GitHub。关键词：MCP 配置，AI 智能体工具，Claude Code 扩展，服务器设置。

AI 智能体 0 次安装 2 次浏览 更新于 3/11/2026

name: mcp-setup description: 配置流行的 MCP 服务器以增强代理能力

MCP 设置

配置模型上下文协议 (MCP) 服务器，以使用外部工具（如网络搜索、文件系统访问和 GitHub 集成）扩展 Claude Code 的能力。

概述

MCP 服务器提供额外的工具，供 Claude Code 代理使用。此技能帮助您使用 claude mcp add 命令行界面配置流行的 MCP 服务器。

步骤 1：显示可用的 MCP 服务器

使用 AskUserQuestion 向用户呈现可用的 MCP 服务器选项：

问题： “您想配置哪个 MCP 服务器？”

选项：

  1. Context7 - 来自流行库的文档和代码上下文
  2. Exa Web Search - 增强的网络搜索（替换内置的 websearch）
  3. Filesystem - 具有额外能力的扩展文件系统访问
  4. GitHub - 用于问题、PR 和仓库管理的 GitHub API 集成
  5. All of the above - 配置所有推荐的 MCP 服务器
  6. Custom - 添加自定义 MCP 服务器

步骤 2：收集所需信息

对于 Context7：

无需 API 密钥。立即可用。

对于 Exa Web Search：

询问 API 密钥：

您有 Exa API 密钥吗？
- 在 https://exa.ai 获取
- 输入您的 API 密钥，或键入 'skip' 以后配置

对于 Filesystem：

询问允许的目录：

文件系统 MCP 应访问哪些目录？
默认：当前工作目录
输入逗号分隔的路径，或按 Enter 使用默认值

对于 GitHub：

询问令牌：

您有 GitHub 个人访问令牌吗？
- 在 https://github.com/settings/tokens 创建
- 推荐范围：repo, read:org
- 输入您的令牌，或键入 'skip' 以后配置

步骤 3：使用 CLI 添加 MCP 服务器

使用 claude mcp add 命令配置每个 MCP 服务器。CLI 自动处理 settings.json 更新和合并。

Context7 配置：

claude mcp add context7 -- npx -y @upstash/context7-mcp

Exa Web Search 配置：

claude mcp add -e EXA_API_KEY=<用户提供的密钥> exa -- npx -y exa-mcp-server

Filesystem 配置：

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem <允许的目录>

GitHub 配置：

选项 1：Docker（本地）

claude mcp add -e GITHUB_PERSONAL_ACCESS_TOKEN=<用户提供的令牌> github -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

选项 2：HTTP（远程）

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

注意：Docker 选项需要安装 Docker。HTTP 选项更简单，但可能有不同的能力。

步骤 4：验证安装

配置后，验证 MCP 服务器是否正确设置：

# 列出配置的 MCP 服务器
claude mcp list

这将显示所有配置的 MCP 服务器及其状态。

步骤 5：显示完成消息

MCP 服务器配置完成！

已配置的服务器：
[列出配置的服务器]

下一步：
1. 重启 Claude Code 以使更改生效
2. 配置的 MCP 工具将对所有代理可用
3. 运行 `claude mcp list` 以验证配置

使用提示：
- Context7：询问库文档（例如，“如何使用 React hooks？”）
- Exa：用于网络搜索（例如，“搜索网络上最新的 TypeScript 功能”）
- Filesystem：扩展的工作目录以外的文件操作
- GitHub：与 GitHub 仓库、问题和 PR 交互

故障排除：
- 如果 MCP 服务器未出现，运行 `claude mcp list` 检查状态
- 确保安装了 Node.js 18+ 以使用 npx 基础的服务器
- 对于 GitHub Docker 选项，确保 Docker 已安装并运行
- 运行 /oh-my-claudecode:omc-doctor 诊断问题

管理 MCP 服务器：
- 添加更多服务器：/oh-my-claudecode:mcp-setup 或 `claude mcp add ...`
- 列出服务器：`claude mcp list`
- 移除服务器：`claude mcp remove <服务器名称>`

自定义 MCP 服务器

如果用户选择“Custom”：

询问：

  1. 服务器名称（标识符）
  2. 传输类型：stdio（默认）或 http
  3. 对于 stdio：命令和参数（例如，npx my-mcp-server）
  4. 对于 http：URL（例如，https://example.com/mcp）
  5. 环境变量（可选，键=值对）
  6. HTTP 头部（可选，仅用于 http 传输）

然后构建并运行适当的 claude mcp add 命令：

对于 stdio 服务器：

# 无环境变量
claude mcp add <服务器名称> -- <命令> [参数...]

# 有环境变量
claude mcp add -e KEY1=value1 -e KEY2=value2 <服务器名称> -- <命令> [参数...]

对于 HTTP 服务器：

# 基本 HTTP 服务器
claude mcp add --transport http <服务器名称> <url>

# 有头部的 HTTP 服务器
claude mcp add --transport http --header "Authorization: Bearer <令牌>" <服务器名称> <url>

常见问题

MCP 服务器未加载

  • 确保安装了 Node.js 18+
  • 检查 PATH 中是否有 npx
  • 运行 claude mcp list 验证服务器状态
  • 检查服务器日志以查找错误

API 密钥问题

  • Exa：在 https://dashboard.exa.ai 验证密钥
  • GitHub：确保令牌有所需范围（repo, read:org）
  • 如果需要，用正确凭据重新运行 claude mcp add

代理仍使用内置工具

  • 配置后重启 Claude Code
  • 配置 exa 时，内置 websearch 将被降级
  • 运行 claude mcp list 确认服务器处于活动状态

移除或更新服务器

  • 移除：claude mcp remove <服务器名称>
  • 更新：移除旧服务器，然后用新配置再次添加