CAP MCP Server Integration Guide，一台真正懂 CAP 项目的本地助手

我最近在看 CAP 项目和 Claude Code、GitHub Copilot Agent mode、Cline、opencode 这些编码代理的结合方式时，最强烈的感受不是模型会不会写代码，而是模型到底有没有拿到正确上下文。没有上下文的 Claude Code 很容易写出看起来很像 CAP 的代码，却不一定贴合当前项目。它可能知道 CDS association 的语法，也可能知道 srv.before 的大概写法，但它并不知道我们当前项目里到底有哪些 service、哪些 entity、哪些 action、哪些 association 已经存在，也不知道最终编译出来的模型和源文件里的片段之间有什么差异。CAP MCP server 解决的正是这个问题，它不是再造一个 CAP runtime，也不是在云端开一个额外服务，而是在本地把 CAP 项目编译后的模型和 CAP 官方文档变成 AI agent 可以调用的上下文工具。

CAP MCP 里的 MCP，全称是 Model Context Protocol。这个协议的价值可以理解成给 AI agent 装上一组可控的工具接口，让 Claude Code、Cline、opencode、GitHub Copilot 这类代理不再只靠 prompt 里的文字猜测项目结构，而是可以主动调用工具查询项目事实。在 CAP 项目里，最关键的事实不是某个.cds文件里孤立写了什么，而是所有 CDS model 编译之后形成的 CSN，也就是 Core Schema Notation。CAP 体系里，CDS 是建模语言，CSN 则是更接近机器可读统一模型的表示方式。一个 enterprise application 里常见的订单、订单行、客户、审批动作、Fiori annotation、