# 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

```bash
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:
```bash
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

```json
{
  "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