Atrax

Atrax: MCP Server Aggregation Proxy v0.1.0

Atrax is a proxy for Model Context Protocol (MCP) servers that aggregates multiple MCP servers and presents them as a single unified interface. The name comes from the funnel-web spider, reflecting how it funnels resources from multiple servers into one.

Features

• Resource Aggregation: Combine resources from multiple servers with configurable conflict resolution
• Transparent Proxying: Present a unified MCP server interface to clients
• Protocol Compliance: Strict adherence to the MCP protocol specification
• Modular Design: Clear separation of concerns between components
• Multiple Transport Types: Support for STDIO, HTTP/SSE, and Docker transports
• Enhanced Error Handling: Detailed error reporting with contextual information
• Web Integration: HTTP/SSE transport for browser and web-based clients
• Authentication Support: Token-based authentication for securing server access

Quick Start

Documentation Map

• DEVELOPMENT.md: Development environment setup and workflow
• GUIDELINES.md: Project guidelines and coding standards
• MCP_SDK_INTEGRATION.md: MCP SDK integration guide
• HTTP_SSE_TRANSPORT.md: HTTP/SSE transport implementation and usage
• TOKEN_AUTH.md: Token authentication guide and usage
• DIRENV.md: Using direnv for environment management
• CLAUDE.md: Quick reference for common commands
• VERSION_MANAGEMENT.md: Guidelines for version management

Examples

The examples/ directory contains example server implementations:

• Memory server: A simple MCP server that stores a knowledge graph in memory
• Echo server: A basic MCP server that echoes back requests
• HTTP Echo server: An MCP server that uses HTTP/SSE transport to communicate

Run examples with:

License

MIT