feat: servidor mcp institucional y asistente interactivo guiado con spotlight didactico (SDD-011, v3.8.27)
This commit is contained in:
@@ -12,6 +12,7 @@ from dependencies import get_optional_current_user, require_roles
|
||||
from app.models.setting import SystemSetting
|
||||
from app.models.user import User
|
||||
from app.services.rag_service import RAGService
|
||||
from app.services.guide_service import GuideService
|
||||
from schemas.ai_chat import (
|
||||
ChatRequest,
|
||||
ChatResponse,
|
||||
@@ -190,10 +191,12 @@ async def get_agent_response(
|
||||
ai_data = response.json()
|
||||
raw_reply = ai_data["choices"][0]["message"]["content"]
|
||||
clean_reply, options = _extract_options_from_reply(raw_reply, effective_role)
|
||||
guide_step = GuideService.detect_guide_step(last_query, effective_role)
|
||||
return ChatResponse(
|
||||
response=clean_reply,
|
||||
quick_options=options,
|
||||
conversation_id=user_identifier
|
||||
conversation_id=user_identifier,
|
||||
guide_step=guide_step
|
||||
)
|
||||
except httpx.TimeoutException:
|
||||
raise HTTPException(
|
||||
|
||||
@@ -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}'"}
|
||||
}
|
||||
Reference in New Issue
Block a user