Atrax: MCP 服务器聚合代理 v0.1.0

              .  .               __
             .|  |.      _____ _/  |_____________  ___  ___
             ||  ||      \__  \\   __\_  __ \__  \ \  \/  /
             \\()//       / __ \|  |  |  | \// __ \_>    <
             .={}=.      (____  /__|  |__|  (____  /__/\_ \
            / /`'\ \          \/                 \/      \/
            ` \  / '
               `'           WEB 版 MCP 代理 v0.1.0

Atrax 是一个 Model Context Protocol (MCP) 服务器的代理，它聚合多个 MCP 服务器并将它们呈现为单个统一的接口。 该名称来自漏斗网蜘蛛，反映了它如何将来自多个服务器的资源汇集到一个服务器中。

特性

• 资源聚合: 结合来自多个服务器的资源，并具有可配置的冲突解决机制
• 透明代理: 向客户端呈现统一的 MCP 服务器接口
• 协议合规性: 严格遵守 MCP 协议规范
• 模块化设计: 组件之间清晰的关注点分离
• 多种传输类型: 支持 STDIO、HTTP/SSE 和 Docker 传输
• 增强的错误处理: 详细的错误报告，包含上下文信息
• Web 集成: HTTP/SSE 传输，适用于浏览器和基于 Web 的客户端
• 身份验证支持: 基于令牌的身份验证，用于保护服务器访问

快速开始

# 克隆仓库
git clone https://github.com/yourusername/atrax.git
cd atrax

# 设置开发环境
direnv allow  # 设置 Python venv 和 pre-commit
npm install

# 构建项目
npm run build

# 运行服务器 (无身份验证)
npm run serve

# 运行服务器 (带令牌身份验证)
npm run serve:auth

# 运行冒烟测试
npm run test:smoke

文档地图

• 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/ 目录包含示例服务器实现：

• Memory server: 一个简单的 MCP 服务器，将知识图存储在内存中
• Echo server: 一个基本的 MCP 服务器，回显请求
• HTTP Echo server: 一个 MCP 服务器，使用 HTTP/SSE 传输进行通信

使用以下命令运行示例：

# 基于 STDIO 的服务器
npm run memory-server
npm run echo-server

# 基于 HTTP/SSE 的服务器
npm run http-echo-server

# 客户端示例
npm run echo-client      # 连接到 STDIO Echo 服务器
npm run memory-client    # 连接到 STDIO Memory 服务器
npm run http-echo-client # 连接到 HTTP/SSE Echo 服务器

许可证

MIT