Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
cd mcp-maestro
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install -r requirements.txt
python3 server.py2
Register it in Claude Code
claude mcp add maestro -- uv --directory /path/to/mcp-maestro run python3 server.pyReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
maestro's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Orchestrates multi-agent research missions including planning and writing
- Automatic discovery of Maestro service ports
- Real-time research task tracking
- Retrieval of structured research reports and notes
Tools 4
maestro_create_missionInitiates a new research mission with a specific description.maestro_get_reportRetrieves the final report for a completed research mission.maestro_resumeResumes a paused or interrupted research mission.maestro_stopStops an ongoing research mission.Environment Variables
MAESTRO_BASE_URLThe base URL for the Maestro backend API (defaults to http://localhost:3000)Try it
→Create a new research mission to analyze the current state of quantum computing.
→Start a research mission about renewable energy trends and include web search.
→Get the final report for my mission with ID 12345.
→Stop the research mission currently running with ID 67890.
Original README from Ruben-Alvarez-Dev/MCP-maestro
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
- Primero: Busca en puerto
3000(web UI) - Si no encuentra: Escanea puertos alternativos (8000, 10303, 8001, 5000, 8080)
- Si sigue sin encontrar: Pide al usuario el puerto por consola
- Fallback: Usa
http://localhost:3000si 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