导入 MCP 客户端配置 — 编码助手使用的三个服务器
一个 Claude Code .mcp.json,列出三个 Model Context Protocol 服务器 — 两个通过命令行启动,一个由他人运行 — 由 aggrega import 起草为 Aggrega 文件,每个服务器都映射到与其运行方式对应的实现,并为 Kubernetes 构建。
导入 MCP 客户端配置 逐步讲解了这一过程:命令、它写入的文件以及每一行存在的原因、构建,以及运行中的服务器。此文件夹保存了该演练的每个阶段:
| 文件夹或文件 | 内容 |
|---|---|
source/ | 客户端配置 .mcp.json、使该文件夹成为工作区的 .aggrega-config.yaml,以及 import-answers.yaml,即读取 GitHub 服务器令牌所用的 Kubernetes Secret 的名称 |
draft/ | aggrega import .mcp.json --target helm 写入的文件(未经修改,包括 release.lock),以及它打印的内容:stdout.txt 为标准输出,import.txt 为标准错误 |
在文档仓库的检出副本中,check.sh 会重新运行导入,将其写入和打印的内容与 draft/ 比较,将演练引用的代码块与这些文件比较,并验证和构建导入所写入的内容。它需要将标准库目录(获取途径)检出在此仓库旁边,或在 AGGREGA_CATALOG_DIRS 中指定其目录。
生成示例
你可以使用下面的命令运行本示例的导入,或者让你的 AI 助手替你运行。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example import-mcp然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd import-mcp构建
导入会在项目旁边的 source/ 中起草 Aggrega 文件。它将项目与标准库目录进行比对,该目录由工作区的默认注册表以签名快照的形式发布:首次导入会获取它、验证它、将它保存在工作区的内容缓存中,并在写在草稿旁边的记录里用其摘要来标识它。指定了自己的目录文件夹的工作区 — 在 AGGREGA_CATALOG_DIRS 中,或在 workspace.catalog_dirs 下 — 则改为依据这些文件夹进行导入。导入从 import-answers.yaml 读取 Secret 的名称,然后拉取所起草的 Release 依赖的内容,因此构建可以紧接着进行:
cd sourceaggrega import .mcp.json --target helmaggrega build --release release.yaml构建会将 Kubernetes 清单写入 dist/helm/;创建 Secret 并应用这些清单的步骤见上方链接的演练。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `import-mcp` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `import-mcp`,不设 `dir`:它会把示例写入一个新的 `import-mcp` 文件夹,其中的 `source` 文件夹包含本示例要导入的内容。然后调用 `import` 工具,将 `workspace_root` 设为 `import-mcp/source`,`source` 设为 `.mcp.json`,`target` 设为 `helm`:它从 `.mcp.json` 旁边的 `import-answers.yaml` 读取所需的答案,将草稿写入 `import-mcp/source`,并拉取草稿所需的内容。然后调用 `validate` 工具,将 `workspace_root` 设为 `import-mcp/source`,`release` 设为 `release.yaml`;再调用 `build` 工具,将 `workspace_root` 设为 `import-mcp/source`,`release` 设为 `release.yaml`,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `import-mcp/source/dist/` 下。测试
应用构建产物后,将一个本地端口转发到 fetch 服务器的 Service,并让该命令保持运行:
kubectl port-forward svc/fetch-default 8080:8080在另一个终端中,请服务器通过 MCP 的 initialize 请求打开一个会话:
curl -sS http://127.0.0.1:8080/mcp \ -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-it", "version": "1.0.0"}}}': keepalive
: keepalive
event: messagedata: {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"protocolVersion":"2025-06-18","serverInfo":{"name":"mcp-fetch","version":"2026.11.11"}}}分步指南 在 Docker Compose 上以及对 GitHub 服务器进行同样的调用。