Maestro MCP Server

MCP server para Maestro (AI Research Platform) con descubrimiento automático de puerto.

Puertos Oficiales

Según la documentación oficial, Maestro se ejecuta en:

• Web UI: puerto 3000

• Backend API: puerto 3001 (a través de nginx en 80)

• PostgreSQL: puerto 5432

Quick Start

cd mcp-maestro
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install -r requirements.txt
python3 server.py

Lógica de Descubrimiento

1. Primero: Busca en puerto 3000 (web UI)

2. Si no encuentra: Escanea puertos alternativos (8000, 10303, 8001, 5000, 8080)

3. Si sigue sin encontrar: Pide al usuario el puerto por consola

4. Fallback: Usa http://localhost:3000 si el usuario no responde

Configuración Manual

Si prefieres configurar manualmente, usa la variable de entorno:

export MAESTRO_BASE_URL=http://localhost:3000

O crea un archivo .env en la raíz del proyecto.

Herramientas

maestro_create_mission

• request (string): Descripción de la misión

• chat_id (string, optional): ID de chat

• use_web_search (boolean): Usar búsqueda web

maestro_get_report

• mission_id (string): ID de la misión

maestro_resume

• mission_id (string): ID de la misión

maestro_stop

• mission_id (string): ID de la misión

Claude Desktop

{
  "mcpServers": {
    "maestro": {
      "command": "uv",
      "args": ["--directory", "/Users/simba/Code/MCP-servers/mcp-maestro", "run", "python3", "server.py"]
    }
  }
}

MCP Server

• Puerto: 8081

• SSE: /sse

• HTTP: /mcp