MCP

1MCP：用 1mcp serve 聚合多台 MCP 服务器

适合要把多台 MCP 收成一个运行时的人；请按官方三步安装并先调用 1mcp instructions，不要第一次就 run。

官方来源 · 1MCP Agent

安装

npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve

适合谁

1MCP 面向要把多台 MCP 服务器收成一个运行时的人。官方写明 1MCP is the unified MCP runtime，1mcp serve aggregates your MCP servers；CLI mode 给 Codex、Claude、Cursor 以及 similar tool-using agents 一条更薄的代理工作流。

更适合你的情况是：你能全局安装 npm 包，并接受先按官方例子加入 context7，再启动 1mcp serve。第一次只做只读发现，调用 1mcp instructions。

不适合的情况是：你还没有 Node/npm，却想跳过安装直接编造后端；或者第一次就 1mcp run 去执行未核对过的工具。官方没有给出 --args 的示例 JSON。

3 分钟完成第一次尝试

前置条件：本机有 npm。官方主路径是这三步，不要改成别的安装器：

npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve

安装位置是全局的 @1mcp/agent。serve 起来后，HTTP 客户端可按官方片段连接到： http://127.0.0.1:3050/mcp?app=cursor

第一次调用用 1mcp instructions。它属于 CLI mode for progressive discovery，用来拿使用说明，比 1mcp run 更低风险。不要带未出现的参数。

成功信号：返回一段 instructions 文本，说明如何继续 inspect 或 run。这会在本机拉起聚合运行时，并按例子通过 npx 拉取 @upstash/context7-mcp，不是“无网络、无本地进程”。

若 serve 没起来，先确认全局 1mcp 命令可用，以及 mcp add 已加入 context7。不要改去只跑 1mcp cli-setup --codex 当成唯一安装。

使用案例

案例一：先读发现说明。在 serve 已运行时执行 1mcp instructions。用返回文本确认 CLI 发现通道可用。不要在这一步传 --args。

案例二：查看某个后端里有什么。官方写出 1mcp inspect <server> 以及 1mcp inspect <server>/<tool>。对官方例子中的 context7 执行 1mcp inspect context7。成功时看到该 server 的工具信息。只有在你已经从 inspect 得到真实工具名之后，才考虑 1mcp run <server>/<tool> --args；原文没有给出 JSON 样例，第一次不要 run。

使用边界

1mcp serve 会聚合你添加的 MCP 服务器，并在 127.0.0.1:3050 提供 HTTP。app=cursor 只是官方示例查询串，不代表必须使用该客户端。

1mcp cli-setup --codex 是 CLI 模式的另一种接线，不是第二条软件包安装通道。1mcp run 会真正执行后端工具，副作用取决于被聚合的服务器，官方没有统一撤销路径。除 instructions、inspect、run 和示例中的 context7 以外，不要编造其他后端名。