Atrax

🚀 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 许可证。