@cap-js/mcp-server Skill 技能

@cap-js/mcp-server 是 SAP 官方维护的 Model Context Protocol（MCP）服务器，专为 SAP Cloud Application Programming Model（CAP）应用开发设计，使 AI 编码助手能够进行 CAP 应用的智能化开发（agentic coding）。

【核心功能】

CDS 模型搜索（search_model）：对 CAP 项目编译后的 CDS 模型（Core Schema Notation）定义进行模糊搜索，返回所有实体（entities）、字段、关联关系和 HTTP 服务端点。当 AI 询问「这个项目有哪些 CDS 服务」「某个 entity 包含哪些字段」「服务之间如何关联」时，工具直接给出答案，无需读取 .cds 文件。CAP 文档语义搜索（search_docs）：基于本地向量嵌入（使用 ONNX Runtime Web 生成，HuggingFace Transformers.js 做 tokenizer 对比），在预处理后的 CAP 文档中进行语义相似度搜索，全部在本地执行，无需联网。当 AI 需要查询 CAP Node.js API 用法、CDS 语法或 cds CLI 使用方式时，直接提供语义相关的最新文档内容。

【技术亮点】

SAP 官方维护，质量有保证；完全本地化的语义搜索，不依赖外部 API（嵌入模型在本地运行）；支持多种 MCP 客户端配置（VS Code Cline、GitHub Copilot mcp.json、opencode 等）；提供 CLI 模式（npm i -g 后直接调用 cds-mcp search_model / search_docs 命令行）；内置 LLM 使用规则（rules），指导 AI 何时必须用 MCP 工具查询 CDS 定义，何时可以读取 .cds 源文件，避免 AI 在 CAP 开发中给出过时或错误的建议。

【适用场景】

使用 SAP CAP（Cloud Application Programming Model）构建企业级应用时，让 AI 助手能够准确理解 CDS 数据模型结构；查询 CAP 最新文档（CDN、Node.js API 等）时避免 AI 给出基于旧版本训练数据的建议；在 VS Code、opencode 等编辑器中，通过 MCP 协议将 CAP 开发知识注入 AI 助手，提升 agentic coding 质量。