Atrax: MCP Server Aggregation Proxy v0.1.0
LocalAbout Atrax: MCP Server Aggregation Proxy v0.1.0
Atrax is a proxy that combines multiple MCP servers behind one interface. It is designed for clients that need unified access to server resources, with several transport options and token-based authentication.
Key features
- 01Aggregate resources from multiple servers
- 02Unified MCP server interface
- 03STDIO, HTTP/SSE, and Docker transports
- 04Configurable resource conflict resolution
- 05Token-based authentication
Use cases
- 01Present several MCP servers through one endpoint
- 02Connect web clients over HTTP/SSE
- 03Secure server access with token authentication
MCP support
Atrax proxies multiple MCP servers and exposes them as a unified MCP server to clients. It supports STDIO, HTTP/SSE, and Docker transports.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEAtrax: 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.