Atrax: MCP Server Aggregation Proxy v0.1.0
2025.04.05
3
TypeScriptMCP 服务器代理资源聚合其它
Atrax 是一个用于 Model Context Protocol (MCP) 服务器的代理工具，能够聚合多个 MCP 服务器资源并通过单一接口提供服务。其名称来源于漏斗网蜘蛛，象征着它如何将多个服务器的资源汇集到一个统一的接口中。
View on GitHub
Overview
基本能力
产品定位
Atrax 是一个 MCP 服务器的代理工具，主要用于聚合多个 MCP 服务器的资源，并通过统一的接口对外提供服务。
核心功能
- 资源聚合：从多个服务器合并资源，支持可配置的冲突解决机制。
- 透明代理：为客户端提供统一的 MCP 服务器接口。
- 协议合规：严格遵守 MCP 协议规范。
- 模块化设计：组件之间职责清晰分离。
- 多传输类型支持：支持 STDIO、HTTP/SSE 和 Docker 传输方式。
- 增强的错误处理：提供详细的错误报告和上下文信息。
- Web 集成：通过 HTTP/SSE 传输支持浏览器和基于 Web 的客户端。
- 认证支持：基于令牌的认证机制，保障服务器访问安全。
适用场景
- 需要将多个 MCP 服务器资源整合到一个统一接口的场景。
- 需要为客户端提供透明代理服务的场景。
- 需要在 Web 环境中使用 MCP 服务的场景。
- 需要增强错误处理和认证机制的场景。
工具列表
- npm：用于项目构建和依赖管理。
- direnv：用于开发环境设置。
- pre-commit：用于代码提交前的自动化检查。
常见问题解答
无具体常见问题解答内容。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 安装 direnv 用于环境管理：
bash brew install direnv - 安装 pre-commit 用于代码提交前的检查：
bash pip install pre-commit
安装教程
- 克隆仓库：
bash git clone https://github.com/yourusername/atrax.git cd atrax - 设置开发环境：
bash direnv allow npm install - 构建项目：
bash npm run build - 运行服务器（无认证）：
bash npm run serve - 运行带认证的服务器：
bash npm run serve:auth - 运行冒烟测试：
bash npm run test:smoke
调试方式
- 运行示例服务器：
bash npm run memory-server npm run echo-server npm run http-echo-server - 运行示例客户端：
bash npm run echo-client npm run memory-client npm run http-echo-client