Toolbox MCP

Implementación de FastMCP para el desafío Toolbox descrito en toolbox.txt.

Instalación

python -m pip install -e ".[dev]"

Related MCP server: MCP Server Learning

Ejecutar localmente

python -m toolbox_mcp.server

El endpoint MCP es http://localhost:8000/mcp. Sobrescribe HOST, PORT o MCP_PATH con variables de entorno al desplegar.

El servidor expone:

• get_name(name) — valida y devuelve el nombre proporcionado.

• calculate(left, operator, right) — evalúa una operación aritmética soportada.

• identify_shape(image_base64) — identifica un PNG como rectangle, triangle o circle.

• list_study_materials() / fetch_study_material(document_id) — enumera o lee el temario de la Fase 2.

• search_study_material(question) — devuelve pasajes relevantes del temario dentro del presupuesto de recuperación.

• next_route_node(map_id, current, destination, visited, hops_remaining) — elige un salto de grafo de menor costo usando pesos de aristas más peajes de nodos ingresados.

• get_venues(day), get_schedule(person, day) y get_location(person, day) — obtienen datos de la ciudad de la Fase 3.

• find_meeting_window(...) — encuentra la ventana limpia más temprana, con compromisos tentativos de la bandeja de entrada como respaldo.

• plan_outing(...) — combina horarios, ubicaciones, lugares y viajes en cuadrícula en una respuesta de salida.

Prueba

python -m pytest -q