用途:该资料介绍如何为 CAP 开发配置并使用官方 SAP MCP Server,让 AI 代理同时理解 CAP API 与具体项目。CAP MCP Server 提供 search_model(在编译后的 CSN 模型中模糊搜索 CDS 实体、服务、动作与关系)和 search_docs(对官方 CAP 文档做语义检索),实现即时模型发现与上下文感知文档查询。
安装:在 CAP 项目中运行 npm install --save-dev @sap/cds-mcp,或全局安装 npm install -g @sap/cds-mcp。
配置:可写入 Claude Code 的 .claude/settings.json 或 ~/.claude/settings.json,例如 {"mcpServers":{"cap":{"command":"npx","args":["@sap/cds-mcp","--project","."],"env":{}}}};OpenCode 用 .opencode/config.json;GitHub Copilot 用 .vscode/mcp.json。UI5 与 Fiori Elements 分别使用 @sap/ui5-mcp-server 和 @sap/fiori-mcp-server。
组合使用:MCP Server 动态查询项目模型与文档,Skills 注入静态最佳实践,建议配合使用。
另一包 @cap-js/mcp(npm install @cap-js/mcp)用于把 CAP 服务暴露为 MCP 端点,用 annotate CatalogService with @mcp; 标注,cds watch 时自动生成 describe、query、call_action 三类工具。
限制与注意:运行 @sap/cds-mcp 需带 --project .,且需先执行 cds build(读取 gen/);避免全局配置需要项目路径的场景;文档检索随版本更新而改进。