Atrax: Proxy de agregación de servidores MCP v0.1.0

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

Atrax es un proxy para servidores de Protocolo de Contexto de Modelo (MCP) que agrupa varios servidores MCP y los presenta como una única interfaz unificada. Su nombre proviene de la araña de tela en embudo, que refleja cómo canaliza recursos de varios servidores a uno solo.

Características

• Agregación de recursos : combine recursos de múltiples servidores con resolución de conflictos configurable

• Proxy transparente : presente una interfaz de servidor MCP unificada a los clientes

• Cumplimiento del protocolo : estricta adhesión a la especificación del protocolo MCP

• Diseño modular : clara separación de preocupaciones entre los componentes

• Múltiples tipos de transporte : compatibilidad con transportes STDIO, HTTP/SSE y Docker

• Manejo de errores mejorado : informes de errores detallados con información contextual

• Integración web : transporte HTTP/SSE para navegadores y clientes basados en web

• Soporte de autenticación : autenticación basada en token para proteger el acceso al servidor

Related MCP server: mcp-gateway

Inicio rápido

# 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

Mapa de documentación

• DESARROLLO.md : Configuración y flujo de trabajo del entorno de desarrollo

• GUIDELINES.md : Directrices de proyecto y estándares de codificación

• MCP_SDK_INTEGRATION.md : Guía de integración del SDK de MCP

• HTTP_SSE_TRANSPORT.md : Implementación y uso del transporte HTTP/SSE

• TOKEN_AUTH.md : Guía y uso de autenticación de tokens

• DIRENV.md : Uso de direnv para la gestión del entorno

• CLAUDE.md : Referencia rápida para comandos comunes

• VERSION_MANAGEMENT.md : Directrices para la gestión de versiones

Ejemplos

El directorio examples/ contiene implementaciones de servidor de ejemplo:

• Servidor de memoria: un servidor MCP simple que almacena un gráfico de conocimiento en la memoria

• Servidor de eco: un servidor MCP básico que refleja las solicitudes

• Servidor de eco HTTP: un servidor MCP que utiliza el transporte HTTP/SSE para comunicarse

Ejecutar ejemplos con:

# 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

Licencia

Instituto Tecnológico de Massachusetts (MIT)