Atrax: MCP Server Aggregation Proxy v0.1.0

Atrax：MCP 服务聚合代理 v0.1.0

              .  .               __
             .|  |.      _____ _/  |_____________  ___  ___
             ||  ||      \__  \\   __\_  __ \__  \ \  \/  /
             \\()//       / __ \|  |  |  | \// __ \_>    <
             .={}=.      (____  /__|  |__|  (____  /__/\_ \
            / /`'\ \          \/                 \/      \/
            ` \  / '
               `'           MCP PROXY FOR THE WEB v0.1.0

Atrax 是一个用于 Model Context Protocol（MCP）服务的代理，可聚合多个 MCP 服务，并将它们呈现为统一的接口。其名称源自漏斗网蜘蛛，寓意将多个服务的资源汇集到一处。

功能

• 资源聚合：合并来自多个服务的资源，并支持可配置的冲突解决方式
• 透明代理：向客户端呈现统一的 MCP 服务接口
• 协议合规：严格遵循 MCP 协议规范
• 模块化设计：清晰划分各组件的职责
• 多种传输类型：支持 STDIO、HTTP/SSE 和 Docker 传输
• 增强的错误处理：提供包含上下文信息的详细错误报告
• Web 集成：为浏览器和基于 Web 的客户端提供 HTTP/SSE 传输
• 身份验证支持：通过基于令牌的身份验证保护服务访问

快速开始

# Clone the repository
git clone https://github.com/yourusername/atrax.git
cd atrax

# Setup development environment
direnv allow  # Sets up Python venv and pre-commit
npm install

# Build the project
npm run build

# Run the server (no authentication)
npm run serve

# Run with token authentication
npm run serve:auth

# Run smoke tests
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/ 目录包含示例服务实现：

• 内存服务：一个将知识图谱存储在内存中的简单 MCP 服务
• Echo 服务：一个会回显请求的基础 MCP 服务
• HTTP Echo 服务：一个使用 HTTP/SSE 传输进行通信的 MCP 服务

运行示例：

# STDIO-based servers
npm run memory-server
npm run echo-server

# HTTP/SSE-based server
npm run http-echo-server

# Client examples
npm run echo-client      # Connect to STDIO Echo server
npm run memory-client    # Connect to STDIO Memory server
npm run http-echo-client # Connect to HTTP/SSE Echo server

许可证

MIT