Atrax: MCP Server Aggregation Proxy v0.1.0

.  .               __
             .|  |.      _____ _/  |_____________  ___  ___
             ||  ||      \__  \\   __\_  __ \__  \ \  \/  /
             \\()//       / __ \|  |  |  | \// __ \_>    <
             .={}=.      (____  /__|  |__|  (____  /__/\_ \
            / /`'\ \          \/                 \/      \/
            ` \  / '
               `'           MCP PROXY FOR THE WEB 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

# 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

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:

# 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

License

MIT