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. tool_contract_catalog

19. search_ui5_sdk

20. search_mdn

21. generate_javascript_function

22. refactor_javascript_code

23. lint_javascript_code

24. security_check_javascript

25. validate_ui5_code

26. validate_ui5_version_compatibility

27. security_check_ui5_app

28. analyze_odata_metadata

29. validate_ui5_odata_usage

30. scaffold_ui5_odata_feature

31. scaffold_project_agents

32. validate_project_agents

33. recommend_project_agents

34. materialize_recommended_agents

35. save_agent_pack

36. list_agent_packs

37. apply_agent_pack

38. refresh_project_context_docs

39. record_agent_execution_feedback

40. rank_agent_packs

41. promote_agent_pack

42. audit_project_mcp_state

43. upgrade_project_mcp

44. ensure_project_mcp_current

45. collect_legacy_project_intake

46. analyze_legacy_project_baseline

47. build_ai_context_index

48. prepare_legacy_project_for_ai

49. scaffold_project_skills

50. validate_project_skills

51. record_skill_execution_feedback

52. rank_project_skills

53. audit_git_worktree_state

54. analyze_git_diff

55. suggest_tests_from_git_diff

56. generate_commit_message_from_diff

57. prepare_safe_commit

58. risk_review_from_diff

59. generate_pr_description

60. branch_hygiene_report

61. conflict_precheck

62. trace_change_ownership

63. smart_stage_changes

64. detect_commit_smells

65. release_notes_from_commits

66. merge_readiness_report

67. merge_action_plan

68. 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.