101 lines
3.2 KiB
Python
101 lines
3.2 KiB
Python
"""
|
|
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}'"}
|
|
}
|