القائمة
配置常用 MCP 服务器以增强 agent 能力
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | mcp-setup |
| description | 配置常用 MCP 服务器以增强 agent 能力 |
| level | 2 |
通过 claude mcp add 命令行接口，配置 Model Context Protocol（MCP）服务器，扩展 Kimi CLI 的能力，引入网页搜索、文件系统访问、GitHub 集成等外部工具。
MCP 服务器为 Kimi CLI agent 提供额外工具。本 skill 帮你用 claude mcp add 配置常用 MCP 服务器。
用 AskUserQuestion，每次只问一个问题，每问不超过 3 个选项。新版 Kimi CLI 会因更大的选项 payload 报无效工具参数，所以把 MCP 选择流分步走。
问题： "你想配置哪种 MCP？"
选项：
追问一个 AskUserQuestion：
问题： "要配置哪套推荐 MCP 组合？"
选项：
把选择映射到要配置的服务器清单。
追问一个 AskUserQuestion：
问题： "先配置哪个服务器？"
选项：
若用户选 更多服务器选项，再问一个 AskUserQuestion：
问题： "你还想添加哪个 MCP 选项？"
选项：
直接跳到下面的 自定义 MCP 服务器 段。
不需要 API key，立即可用。
索取 API key：
你有 Exa API key 吗？
- 可以在这里获取：https://exa.ai
- 输入你的 API key，或输入 'skip' 稍后再配置
询问允许访问的目录：
Filesystem MCP 可以访问哪些目录？
默认：当前工作目录
输入用英文逗号分隔的路径，或直接回车使用默认值
索取 token：
你有 GitHub Personal Access Token 吗？
- 可以在这里创建：https://github.com/settings/tokens
- 推荐 scope：repo、read:org
- 输入你的 token，或输入 'skip' 稍后再配置
用 claude mcp add 命令配置每个 MCP 服务器。CLI 会自动处理 settings.json 的更新与合并。
claude mcp add context7 -- npx -y @upstash/context7-mcp
claude mcp add -e EXA_API_KEY=<user-provided-key> exa -- npx -y exa-mcp-server
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem <allowed-directories>
方案 1：Docker（本地）
claude mcp add -e GITHUB_PERSONAL_ACCESS_TOKEN=<user-provided-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 选项更简单，但能力可能有差异。
配置完成后验证 MCP 服务器是否就绪：
# 列出已配置的 MCP 服务器
claude mcp list
这会展示所有已配置的 MCP 服务器及其状态。
MCP 服务器配置完成！
已配置服务器：
[列出本次配置的服务器]
下一步：
1. 重启 Kimi CLI，让配置生效
2. 已配置的 MCP 工具会对所有 agent 可用
3. 运行 `claude mcp list` 验证配置
使用提示：
- Context7：询问库文档（例如："React hooks 怎么用？"）
- Exa：用于网页搜索（例如："搜索最新 TypeScript 特性"）
- Filesystem：执行工作目录之外的扩展文件操作
- GitHub：操作 GitHub 仓库、issue 和 PR
故障排查：
- 如果 MCP 服务器没有出现，运行 `claude mcp list` 检查状态
- 对基于 npx 的服务器，确保已安装 Node.js 18+
- 如果使用 GitHub Docker 方案，确保 Docker 已安装并正在运行
- 运行 /oh-my-kimi:omc-doctor 诊断问题
管理 MCP 服务器：
- 添加更多服务器：/oh-my-kimi:mcp-setup 或 `claude mcp add ...`
- 列出服务器：`claude mcp list`
- 删除服务器：`claude mcp remove <server-name>`
当用户选「自定义服务器」时：
询问：
stdio（默认）或 httpnpx my-mcp-server）https://example.com/mcp）然后构造并跑对应的 claude mcp add 命令：
stdio 服务器：
# 不带环境变量
claude mcp add <server-name> -- <command> [args...]
# 带环境变量
claude mcp add -e KEY1=value1 -e KEY2=value2 <server-name> -- <command> [args...]
HTTP 服务器：
# 基础 HTTP 服务器
claude mcp add --transport http <server-name> <url>
# 带 header 的 HTTP 服务器
claude mcp add --transport http --header "Authorization: Bearer <token>" <server-name> <url>
如果该自定义服务器是为 oh-my-kimi 工作流提供组织级参考材料，建议提供一个名为 get_company_context 的工具，并通过 { context: string } 返回 markdown。
本地注册示例：
claude mcp add company-context -- node examples/vendor-mcp-server/server.mjs
然后在 .claude/omc.jsonc 或 ~/.config/claude-omc/config.jsonc 把 oh-my-kimi 指向完整工具名：
{
"companyContext": {
"tool": "mcp__company-context__get_company_context",
"onError": "warn"
}
}
它仍然只是 prompt 中的咨询性上下文，不做运行时强制。
npx 在 PATH 上claude mcp list 检查状态claude mcp addclaude mcp list 确认服务器在线claude mcp remove <server-name>oh-my-kimi 的目录入口，包含面向 Kimi CLI 的 agent、skill、hook 与 MCP 套件，衍生自 oh-my-* 谱系。
面向密钥、注入、authz/authn、不安全 IO、依赖与数据外泄风险的安全评审
证据驱动的追踪通道，在 Kimi 的 Agent 工具中编排互相竞争的 tracer 假设
LLM Wiki —— 跨会话持续累积的 markdown 知识库（Karpathy 模型）
面向作家的 agentic 记忆系统 —— 跟踪人物、关系、场景与主题
跑只读的深度仓库分析，返回一份带置信度排序的综合结论，附具体文件引用、清晰区分证据与推断。当用户说 'analyze'、'investigate'、'why does'、'what's causing'，或在提任何改动方案之前需要跨文件的有据解释时使用。