Apollo Config MCP

apollo配置mcp

最小的Claude MCP服务器 Apollo配置服务.

此服务将Apollo Config HTTP API公开为Claude MCP工具，以便Claude Code/Codex可以加载 配置命名空间直接来自Apollo。

特性

• 实现Claude MCP HTTP接口(/schema, /tools, /call)
• 提供 getApolloConfig 包裹阿波罗号的工具 GET /configs/{appId}/{cluster}/{namespace} 端点
• 通过以下方式支持基于环境的配置 .env
• 简单的内存响应缓存，具有60秒的TTL，用于重复查找

入门

先决条件

• Node.js 18或更新版本
• pnpm （或 npm/yarn，但以下示例使用 pnpm)

安装

pnpm install

配置

复制 .env.example 到 .env 并调整Apollo配置基本URL：

cp .env.example .env
# Edit .env to point to your Apollo Config Service

所需变量：

• APOLLO_BASE_URL –Apollo配置服务实例的基本URL（例如。 http://apollo-configservice.company.com)

可选变量：

• PORT –MCP服务器的端口（默认为 3333)

运行MCP服务器

pnpm start

您应该看到类似于以下内容的控制台输出：

[apollo-config-mcp] Server listening on port 3333

MCP端点

• GET /schema –返回MCP模式定义
• GET /tools –列出支持的工具
• POST /call –执行工具（预期 { "name": "toolName", "arguments": { ... } })

添加到克劳德代码

1. 在本地启动MCP服务器(pnpm start).
2. 在克劳德代码中，打开 设置→ MCP服务器.
3. 添加指向的新HTTP MCP服务器 http://localhost:3333 （或您配置的端口）。
4. Claude Code将自动加载模式和可用工具。

工具调用示例

服务器运行时，Claude Code可以通过MCP调用该工具：

getApolloConfig appId="my-app" cluster="default" namespace="application"

如果Apollo配置服务有该命名空间的数据，MCP服务器将返回JSON配置有效负载。

项目结构

apollo-config-mcp/
├─ package.json
├─ index.js
├─ mcp/
│  ├─ tools/
│  │  └─ getApolloConfig.js
│  └─ schema.json
├─ .env.example
└─ README.md

许可证

麻省理工学院