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