feat: servidor mcp institucional y asistente interactivo guiado con spotlight didactico (SDD-011, v3.8.27)

This commit is contained in:
2026-10-27 08:23:04 -03:00
parent a5b014efbe
commit bf5b7c3ae7
20 changed files with 1339 additions and 12 deletions
+100
View File
@@ -0,0 +1,100 @@
"""
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}'"}
}