Content
# Atrax: MCP Server Aggregation Proxy v0.1.0
```
. . __
.| |. _____ _/ |_____________ ___ ___
|| || \__ \\ __\_ __ \__ \ \ \/ /
\\()// / __ \| | | | \// __ \_> <
.={}=. (____ /__| |__| (____ /__/\_ \
/ /`'\ \ \/ \/ \/
` \ / '
`' MCP PROXY FOR THE WEB v0.1.0
```
[](https://github.com/pre-commit/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
## Quick Start
```bash
# 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](./docs/DEVELOPMENT.md)**: Development environment setup and workflow
- **[GUIDELINES.md](./docs/GUIDELINES.md)**: Project guidelines and coding standards
- **[MCP_SDK_INTEGRATION.md](./docs/MCP_SDK_INTEGRATION.md)**: MCP SDK integration guide
- **[HTTP_SSE_TRANSPORT.md](./docs/HTTP_SSE_TRANSPORT.md)**: HTTP/SSE transport implementation and usage
- **[TOKEN_AUTH.md](./docs/TOKEN_AUTH.md)**: Token authentication guide and usage
- **[DIRENV.md](./docs/DIRENV.md)**: Using direnv for environment management
- **[CLAUDE.md](./CLAUDE.md)**: Quick reference for common commands
- **[VERSION_MANAGEMENT.md](./docs/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:
```bash
# 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
MCP Store