Servidor MCP SAPUI5

Servidor MCP especializado para desarrollo SAPUI5/Fiori en JavaScript, con herramientas modulares para analisis de proyectos, generacion de codigo, refactorizacion, validacion y consulta de documentacion.

Arquitectura

src/
  index.js
  server/
    mcpServer.js
    toolRegistry.js
  tools/
    agents/
      recommendProjectAgents.js
      materializeRecommendedAgents.js
      scaffoldProjectAgents.js
      validateProjectAgents.js
      saveAgentPack.js
      listAgentPacks.js
      applyAgentPack.js
      refreshProjectContextDocs.js
      recordAgentExecutionFeedback.js
      rankAgentPacks.js
      promoteAgentPack.js
      auditProjectMcpState.js
      upgradeProjectMcp.js
      ensureProjectMcpCurrent.js
      collectLegacyProjectIntake.js
      analyzeLegacyProjectBaseline.js
      buildAiContextIndex.js
      prepareLegacyProjectForAi.js
      scaffoldProjectSkills.js
      validateProjectSkills.js
      recordSkillExecutionFeedback.js
      rankProjectSkills.js
    ui5/
      catalogs/
        ui5ComponentFitRules.js
        ui5SymbolCatalog.js
      generateController.js
      generateFragment.js
      generateFormatter.js
      generateViewLogic.js
      generateFeature.js
      manageI18n.js
      analyzePerformance.js
      analyzeODataMetadata.js
      validateUi5Code.js
      validateUi5VersionCompatibility.js
      validateUi5ODataUsage.js
      scaffoldUi5ODataFeature.js
      securityCheckUi5App.js
    javascript/
      generateFunction.js
      refactorCode.js
      lintCode.js
      securityCheck.js
    project/
      analyzeProject.js
      auditGitWorktreeState.js
      analyzeGitDiff.js
      suggestTestsFromGitDiff.js
      generateCommitMessageFromDiff.js
      prepareSafeCommit.js
      riskReviewFromDiff.js
      generatePrDescription.js
      branchHygieneReport.js
      conflictPrecheck.js
      traceChangeOwnership.js
      smartStageChanges.js
      detectCommitSmells.js
      releaseNotesFromCommits.js
      mergeReadinessReport.js
      mergeActionPlan.js
      readFile.js
      searchFiles.js
      analyzeCurrentFile.js
      syncManifest.js
      writePreview.js
      applyPatch.js
      rollbackPatch.js
      runProjectQualityGate.js
      mcpHealthReport.js
      mcpMetricsDashboard.js
    documentation/
      cacheStore.js
      searchUI5SDK.js
      searchMDN.js
    index.js
  utils/
    fileSystem.js
    manifestSync.js
    parser.js
    refactor.js
    patchWriter.js
    agentPolicy.js
    mcpProjectLayout.js
    xmlParser.js
    validator.js
    logger.js
    telemetry.js
    git.js
    errors.js
    http.js

Herramientas MCP implementadas

1. analyze_ui5_project
2. generate_ui5_controller
3. generate_ui5_fragment
4. generate_ui5_formatter
5. generate_ui5_view_logic
6. generate_ui5_feature
7. manage_ui5_i18n
8. analyze_ui5_performance
9. read_project_file
10. search_project_files
11. analyze_current_file
12. sync_manifest_json
13. write_project_file_preview
14. apply_project_patch
15. rollback_project_patch
16. run_project_quality_gate
17. mcp_health_report
18. search_ui5_sdk
19. search_mdn
20. generate_javascript_function
21. refactor_javascript_code
22. lint_javascript_code
23. security_check_javascript
24. validate_ui5_code
25. validate_ui5_version_compatibility
26. security_check_ui5_app
27. analyze_odata_metadata
28. validate_ui5_odata_usage
29. scaffold_ui5_odata_feature
30. scaffold_project_agents
31. validate_project_agents
32. recommend_project_agents
33. materialize_recommended_agents
34. save_agent_pack
35. list_agent_packs
36. apply_agent_pack
37. refresh_project_context_docs
38. record_agent_execution_feedback
39. rank_agent_packs
40. promote_agent_pack
41. audit_project_mcp_state
42. upgrade_project_mcp
43. ensure_project_mcp_current
44. collect_legacy_project_intake
45. analyze_legacy_project_baseline
46. build_ai_context_index
47. prepare_legacy_project_for_ai
48. scaffold_project_skills
49. validate_project_skills
50. record_skill_execution_feedback
51. rank_project_skills
52. audit_git_worktree_state
53. analyze_git_diff
54. suggest_tests_from_git_diff
55. generate_commit_message_from_diff
56. prepare_safe_commit
57. risk_review_from_diff
58. generate_pr_description
59. branch_hygiene_report
60. conflict_precheck
61. trace_change_ownership
62. smart_stage_changes
63. detect_commit_smells
64. release_notes_from_commits
65. merge_readiness_report
66. merge_action_plan
67. mcp_metrics_dashboard

Todas las herramientas se descubren dinamicamente a traves del registro central en src/tools/index.js y se registran en MCP con registerTool(...), incluyendo:

• name
• description
• input schema
• output schema

Fiabilidad y seguridad

• Registro de herramientas compatible con JSON-RPC y MCP mediante @modelcontextprotocol/sdk.
• Validacion estructurada de entrada y salida con zod.
• Forma de salida determinista mediante structuredContent.
• Acceso a archivos limitado en sandbox a la raiz del workspace.
• Proteccion frente a path traversal (bloqueo de .. y de resoluciones fuera de la raiz).
• Respuestas de error estructuradas con code y message legibles por maquina.
• Registro centralizado para fallos de herramientas y eventos del ciclo de vida.
• Aplicacion de politicas a nivel de proyecto mediante .codex/mcp/policies/agent-policy.json en flujos de ranking, recomendacion y puerta de calidad.
• Verificacion automatica del proyecto MCP al arrancar el servidor (se desactiva con MCP_AUTO_ENSURE_PROJECT=false).
• Preparacion automatica del contexto legacy al arrancar (se desactiva con MCP_AUTO_PREPARE_CONTEXT=false).

Ejecucion

npm install
npm run start

Observabilidad y logs

El servidor genera telemetria estructurada de uso y rendimiento para analizar la adopcion inicial y detectar cuellos de botella.

• Eventos por sesion en .mcp-runtime/logs/telemetry-events-<sessionId>.jsonl
• Resumen agregado en .mcp-runtime/logs/telemetry-session-latest.json
• Variables de entorno soportadas:
  • MCP_TELEMETRY_ENABLED=false
  • MCP_TELEMETRY_DIR=.mcp-runtime/logs
  • MCP_TELEMETRY_SLOW_THRESHOLD_MS=2000

Ejemplos de llamadas a herramientas

analyze_ui5_project

{
  "tool": "analyze_ui5_project",
  "arguments": {}
}

generate_ui5_controller

{
  "tool": "generate_ui5_controller",
  "arguments": {
    "controllerName": "demo.app.controller.Main",
    "methods": ["onPressSave", "onNavBack"]
  }
}

read_project_file

{
  "tool": "read_project_file",
  "arguments": {
    "path": "webapp/controller/Main.controller.js"
  }
}

generate_javascript_function

{
  "tool": "generate_javascript_function",
  "arguments": {
    "description": "crear un envoltorio fetch con cache",
    "runtime": "node",
    "typescript": false
  }
}

Configuracion MCP para Codex

{
  "mcpServers": {
    "sapui5": {
      "command": "node",
      "args": ["/ruta/absoluta/a/MCPServerUI5/src/index.js"]
    }
  }
}

Documentacion ampliada

Consulta la documentacion para puesta en marcha y mantenimiento en docs/README.md.