Supports Docker transport for running MCP servers within containers, facilitating containerized deployment
Provides repository integration for cloning and managing the codebase from GitHub
Uses npm for package management, building, and running server examples
Integrates with pre-commit for code quality checks and standardization, as indicated by the pre-commit badge
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Atraxlist all available resources from my connected servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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:smokeDocumentation 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 serverLicense
MIT