Atrax

🚀 Atrax: MCP Server Aggregation Proxy v0.1.0

Atrax is a proxy designed to aggregate multiple MCP servers and present them through a unified interface. Its name is derived from the funnel-web spider, symbolizing its function of converging resources from multiple servers into one point.

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

✨ Features

• Resource Aggregation: Combine resources from multiple servers with configurable conflict resolution.
• Transparent Proxy: Present a unified MCP server interface to clients.
• Protocol Compliance: Strictly adhere to MCP protocol specifications.
• Modular Design: Clear division of responsibilities among components.
• Multiple Transport Types: Support STDIO, HTTP/SSE, and Docker transports.
• Enhanced Error Handling: Detailed error reports with context information.
• Web Integration: HTTP/SSE transport for browsers and web-based clients.
• Authentication Support: Token-based authentication to protect server access.

🚀 Quick Start

# Clone the repository
git clone https://github.com/yourusername/atrax.git
cd atrax

# Set up the development environment
direnv allow  # Set up Python virtual environment and pre-commit
npm install

# Build the project
npm run build

# Run the server (without authentication)
npm run serve

# Run with token authentication
npm run serve:auth

# Run smoke tests
npm run test:smoke

📚 Documentation

• 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: Version management guide.

💻 Usage Examples

The examples/ directory contains example server implementations:

• Memory Server: A simple MCP server with the knowledge graph stored in memory.
• Echo Server: A basic MCP server that returns the request content.
• HTTP Echo Server: An MCP server that communicates using HTTP/SSE transport.

Run example commands:

# 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 the STDIO echo server
npm run memory-client    # Connect to the STDIO memory server
npm run http-echo-client # Connect to the HTTP/SSE echo server

📄 License

MIT