MCP 聚合器

一个通用聚合器，用于将多个 MCP（模型上下文协议）服务器组合成单个端点，供AI助手访问各种工具和功能。

特性

• 🔍 自动发现 - 自动查找已安装的MCP服务器
• 🚀 零配置 - 使用合理的默认设置开箱即用
• 🔧 高度可配置 - 需要时自定义每个方面
• 🏗️ 多服务器支持 - 聚合多个MCP服务器
• 🔄 热重载 - 添加/移除服务器无需重启
• 📊 健康监控 - 自动健康检查和恢复
• 🔒 默认安全 - 没有硬编码的秘密或路径

快速开始

# 全局安装
npm install -g @mcp/aggregator

# 运行设置
mcp-aggregator setup

# 启动聚合器
mcp-aggregator start

安装

从 npm 安装

npm install -g @mcp/aggregator

从源码安装

git clone https://github.com/dwillitzer/mcp-aggregator.git
cd mcp-aggregator
npm install
npm run build
npm link

使用 Docker

docker pull ghcr.io/dwillitzer/mcp-aggregator:latest
docker run -d -p 3000:3000 ghcr.io/dwillitzer/mcp-aggregator:latest

配置

聚合器使用灵活的配置系统：

1. 环境变量 - 覆盖任何设置
2. 配置文件 - ~/.mcp/aggregator/config.json
3. 自动发现 - 自动查找服务器
4. 默认设置 - 一切都有合理的默认值

基本配置

{
  "aggregator": {
    "port": 3000,
    "host": "localhost"
  },
  "servers": {
    "filesystem": {
      "enabled": true,
      "command": "mcp-server-filesystem"
    },
    "shell": {
      "enabled": true,
      "command": "mcp-server-shell"
    }
  }
}

可用的 MCP 服务器

聚合器可以与任何符合MCP标准的服务器一起工作。常见的服务器包括：

• filesystem - 文件操作（读取、写入、列出）
• shell - 命令执行
• git - 版本控制操作
• browser - 网络自动化
• slack - Slack集成
• github - GitHub操作
• 1password - 密钥管理

与 Claude 的使用

Claude Desktop

添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "aggregator": {
      "command": "mcp-aggregator",
      "args": ["start", "--stdio"]
    }
  }
}

Claude Guard

聚合器与 Claude Guard 完美集成：

# 如果已安装则自动检测
claude-guard --mcp-status

# 或指定自定义路径
claude-guard --mcp-aggregator /path/to/aggregator

文档

• 入门指南
• 配置指南
• 服务器集成
• API 参考
• 部署指南
• 故障排除

开发

# 克隆仓库
git clone https://github.com/dwillitzer/mcp-aggregator.git
cd mcp-aggregator

# 安装依赖
npm install

# 在开发模式下运行
npm run dev

# 运行测试
npm test

# 构建生产版本
npm run build

贡献

欢迎贡献！请阅读我们的贡献指南，了解我们的行为准则以及提交拉取请求的过程。

许可证

该软件由Daniel Willitzer专有，具有特定的使用权限。

关键点：

• ✅ 免费使用、修改和分发
• ✅ 允许商业用途
• ⚠️ 衍生作品必须声明：“这是一个基于Daniel Willitzer的MCP Aggregator的衍生作品”
• ⚠️ 必须标明所做的修改

详见LICENSE以获取全部细节。

安全

对于安全问题，请发送邮件至daniel@willitzer.com，而不是使用问题追踪器。