适合谁
- 使用 Codex、Claude、Cursor 或类似工具的用户，希望保持 MCP 后端但减少上下文负担。
- 需要跨多个客户端和项目一致管理 MCP 配置的团队。
A
43FMRS · D
1MCP 是一个功能丰富的统一 MCP 运行时，旨在管理 MCP 服务器的扩展和代理工作流。它提供了强大的 CLI 模式，支持渐进式工具发现，并支持模板服务器和集中配置。然而，它引入了额外的运行时依赖和复杂性，可能不适合简单的用例或原生 MCP 客户端。
1MCP 是一个统一的模型上下文协议（MCP）运行时，允许多个 MCP 服务器聚合成一个单一的 serve 进程。它提供 CLI 模式，支持通过 instructions、inspect 和 run 命令进行渐进式工具发现，并支持模板服务器、指令聚合、预设和过滤器。该服务器适合需要集中配置、认证和运行时生命周期管理的用户，可在多个客户端和项目之间共享 MCP 服务器。
工具能力
instructions
提供当前运行时和推荐流程的说明。
inspect
仅发现所需服务器或工具的详细信息。
run
在检查架构后执行所选工具。
安装接入
全局安装 @1mcp/agent：npm install -g @1mcp/agent。然后添加上游服务器：1mcp mcp add context7 -- npx -y @upstash/context7-mcp，并启动运行时：1mcp serve。在第二个 shell 中，将代理连接到 CLI 模式：1mcp cli-setup --codex 或 1mcp cli-setup --claude --scope repo --repo-root .。
选型与风险
不适合谁
- 不需要项目上下文且希望直接使用 MCP 的原生 HTTP MCP 客户端。
- 希望避免额外运行时依赖的简单单服务器场景。
所需权限
- 可能通过网络连接到上游 MCP 服务器。
- 可能读取和写入本地文件系统以进行配置和缓存。
- 可能启动和管理子进程（用于 stdio 后端）。
风险与副作用
- 作为聚合运行时，它引入了一个额外的故障点。
- 如果未正确配置过滤或预设，可能暴露的工具面比预期更广。
- 模板服务器解析依赖客户端的上下文，可能带来意外行为。
常见排障
- 确保 `1mcp serve` 正在运行，且 CLI 命令在第二个 shell 中执行。
- 检查 `.1mcprc` 配置文件以确保正确设置。
- 验证上游服务器是否可访问且已正确添加。
使用场景
为编码代理提供一个稳定的运行时，同时保持较小的操作面。
在 Cursor、Claude Code、Codex 和内部工具之间共享相同的 MCP 服务器清单。
按仓库、分支或会话公开特定于上下文的模板服务器。
集中认证、过滤、预设和运行时生命周期管理。
支持客户端
Claude Desktop完整支持
Codex完整支持
Cursor完整支持