Apollo配置MCP服务

一个将Apollo配置服务的HTTP API暴露为Claude MCP工具的服务,使Claude Code/Codex可以直接从Apollo加载配置命名空间。

  • by gene1979
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 gene1979/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

许可证

麻省理工学院