Atrax: MCP Server Aggregation Proxy v0.1.0

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

pre-commit

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

Related MCP server: mcprouter

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