""" routers/mcp.py - Router FastAPI para el Servidor MCP de Edu-Space (SDD-011) Expone contratos OpenAPI y endpoints compatibles con JSON-RPC 2.0 y REST. """ from typing import Dict, Any, Optional from fastapi import APIRouter, HTTPException, status from pydantic import BaseModel, Field from mcp_server import EduSpaceMCPServer router = APIRouter(prefix="", tags=["Model Context Protocol (MCP)"]) class MCPToolExecutionRequest(BaseModel): name: str = Field(..., description="Nombre de la herramienta MCP a ejecutar") arguments: Optional[Dict[str, Any]] = Field(default_factory=dict, description="Parámetros de la herramienta") class JSONRPCRequest(BaseModel): jsonrpc: str = Field("2.0", description="Versión del protocolo JSON-RPC") id: Optional[Any] = Field(None, description="Identificador de la petición") method: str = Field(..., description="Método MCP: tools/list, tools/call") params: Optional[Dict[str, Any]] = Field(default_factory=dict, description="Parámetros del método") @router.get("/tools") def list_mcp_tools(): """Lista el catálogo de herramientas institucionales expuestas por el servidor MCP.""" return { "status": "success", "tools": EduSpaceMCPServer.get_tools_manifest() } @router.post("/execute") def execute_mcp_tool(request: MCPToolExecutionRequest): """Ejecuta una herramienta del catálogo MCP de Edu-Space vía REST.""" result = EduSpaceMCPServer.execute_tool(request.name, request.arguments or {}) if "error" in result: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail=result["error"] ) return { "status": "success", "tool": request.name, "result": result } @router.post("") @router.post("/") def jsonrpc_mcp_endpoint(req: JSONRPCRequest): """ Endpoint estándar compatible con el protocolo MCP (JSON-RPC 2.0). Soporta 'tools/list' y 'tools/call'. """ if req.jsonrpc != "2.0": return { "jsonrpc": "2.0", "id": req.id, "error": {"code": -32600, "message": "Versión JSON-RPC inválida, debe ser 2.0"} } if req.method in ["tools/list", "tools.list"]: return { "jsonrpc": "2.0", "id": req.id, "result": { "tools": EduSpaceMCPServer.get_tools_manifest() } } elif req.method in ["tools/call", "tools.call"]: params = req.params or {} name = params.get("name") arguments = params.get("arguments", {}) if not name: return { "jsonrpc": "2.0", "id": req.id, "error": {"code": -32602, "message": "Parámetro 'name' requerido para tools/call"} } tool_result = EduSpaceMCPServer.execute_tool(name, arguments) return { "jsonrpc": "2.0", "id": req.id, "result": { "content": [{"type": "text", "text": str(tool_result)}], "data": tool_result } } else: return { "jsonrpc": "2.0", "id": req.id, "error": {"code": -32601, "message": f"Método MCP no soportado: '{req.method}'"} }