Atrax: MCP Server Aggregation Proxy v0.1.0

What is Atrax?

Atrax is a proxy for Model Context Protocol (MCP) servers that aggregates multiple MCP servers and presents them as a single unified interface. It funnels resources from multiple servers into one, much like a funnel‑web spider.

How to use Atrax?

Clone the repository, set up the development environment with direnv allow and npm install, then build with npm run build. Run the server without authentication using npm run serve, or with token authentication using npm run serve:auth. Examples of STDIO‑ and HTTP/SSE‑based servers and clients are available under the examples/ directory.

Key features of Atrax

• Resource aggregation with configurable conflict resolution
• Transparent proxying – presents a unified MCP server interface
• Multiple transport types: STDIO, HTTP/SSE, and Docker transports
• Web integration via HTTP/SSE transport for browser‑based clients
• Token‑based authentication for securing server access
• Enhanced error handling with contextual information

Use cases of Atrax

• Combine resources from several MCP servers into a single endpoint for clients
• Simplify client configuration by hiding the complexity of multiple server backends
• Serve MCP resources over HTTP/SSE to enable web‑ and browser‑based integrations
• Secure access to aggregated MCP servers with token authentication
• Test and demo MCP server aggregation using the included memory and echo examples

FAQ from Atrax

What transport types does Atrax support?

Atrax supports STDIO, HTTP/SSE, and Docker transports.

How do I enable authentication?

Run the server with npm run serve:auth to enable token‑based authentication. Detailed guidance is in the TOKEN_AUTH.md documentation.

Can I combine resources from different MCP servers?

Yes, Atrax aggregates resources from multiple servers and allows configurable conflict resolution.

Where can I find example servers and clients?

Example implementations (memory server, echo server, HTTP echo server) and corresponding clients are in the examples/ directory.

Is Atrax compliant with the MCP protocol specification?

Yes, the project emphasises strict adherence to the MCP protocol specification.