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

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

预先提交

Atrax 是模型上下文协议 (MCP) 服务器的代理，它可以聚合多个 MCP 服务器，并将它们呈现为一个统一的界面。其名称源于漏斗网蜘蛛，反映了它如何将多个服务器的资源汇集到一个服务器上。

特征

资源聚合：将来自多个服务器的资源与可配置的冲突解决方案结合起来
透明代理：向客户端提供统一的 MCP 服务器接口
协议合规性：严格遵守MCP协议规范
模块化设计：组件之间关注点的明确分离
多种传输类型：支持 STDIO、HTTP/SSE 和 Docker 传输
增强的错误处理：带有上下文信息的详细错误报告
Web 集成：用于浏览器和基于 Web 的客户端的 HTTP/SSE 传输
身份验证支持：基于令牌的身份验证，确保服务器访问安全

Related MCP server: mcprouter

快速入门

# 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 ：Token 认证指南及使用
DIRENV.md : 使用 direnv 进行环境管理
CLAUDE.md ：常用命令的快速参考
VERSION_MANAGEMENT.md ：版本管理指南

示例

examples/目录包含示例服务器实现：

内存服务器：一个简单的 MCP 服务器，将知识图存储在内存中
回显服务器：回显请求的基本 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