🚀 Atrax: MCP 服务器聚合代理 v0.1.0
Atrax 是一个用于聚合多个 MCP 服务器的代理，它能将多个服务器的资源汇聚起来，并以统一接口呈现给用户。其名字来源于漏斗网蜘蛛，形象地象征着它将来自多个服务器的资源汇聚到一点的强大功能。
. . __
.| |. _____ _/ |_____________ ___ ___
|| || \__ \\ __\_ __ \__ \ \ \/ /
\\()// / __ \| | | | \// __ \_> <
.={}=. (____ /__| |__| (____ /__/\_ \
/ /`'\ \ \/ \/ \/
` \ / '
`' MCP WEB PROXY v0.1.0
🚀 快速开始
# 克隆仓库
git clone https://github.com/yourusername/atrax.git
cd atrax
# 设置开发环境
direnv allow # 设置 Python 虚拟环境和 pre-commit
npm install
# 构建项目
npm run build
# 运行服务器（无身份验证）
npm run serve
# 带令牌身份验证运行
npm run serve:auth
# 运行烟雾测试
npm run test:smoke
✨ 主要特性
- 资源聚合：结合多个服务器的资源，带有可配置冲突解决。
- 透明代理：向客户端呈现一个统一的 MCP 服务器界面。
- 协议符合性：严格遵守 MCP 协议规范。
- 模块化设计：组件之间有清晰的职责划分。
- 多种传输类型：支持 STDIO、HTTP/SSE 和 Docker 传输。
- 增强错误处理：详细的错误报告，带上下文信息。
- Web 集成：HTTP/SSE 传输用于浏览器和基于 Web 的客户端。
- 身份验证支持：基于令牌的身份验证，保护服务器访问。
📚 详细文档
- DEVELOPMENT.md：开发环境设置和工作流程。
- GUIDELINES.md：项目指南和编码标准。
- MCP_SDK_INTEGRATION.md：MCP SDK 集成指南。
- HTTP_SSE_TRANSPORT.md：HTTP/SSE 传输实现和使用。
- TOKEN_AUTH.md：令牌身份验证指南和使用。
- DIRENV.md：使用 direnv 进行环境管理。
- CLAUDE.md：常用命令快速参考。
- VERSION_MANAGEMENT.md：版本管理指南。
💻 使用示例
基础用法
examples/ 目录包含示例服务器实现：
- 内存服务器：一个简单的 MCP 服务器，知识图谱存储在内存中。
- 回声服务器：一个基本的 MCP 服务器，返回请求内容。
- HTTP 回声服务器：使用 HTTP/SSE 传输进行通信的 MCP 服务器。
运行示例命令：
# 基于 STDIO 的服务器
npm run memory-server
npm run echo-server
# 基于 HTTP/SSE 的服务器
npm run http-echo-server
# 客户端示例
npm run echo-client # 连接到 STDIO 回声服务器
npm run memory-client # 连接到 STDIO 内存服务器
npm run http-echo-client # 连接到 HTTP/SSE 回声服务器
📄 许可证
本项目采用 MIT 许可证。