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