适合谁
- 使用 SAPUI5、CAP、BTP、ABAP 等技术的 SAP 开发者
- 希望在编辑器或 AI 助手中直接检索 SAP 官方与社区文档的团队
- 需要离线或受限网络环境下本地索引检索的场景
- 关注 clean core 合规与 SAP 已发布对象状态的开发者
S
65FMRS · C
这是一个社区维护的 SAP 文档检索 MCP 服务器，将 BM25 关键词检索与语义嵌入检索融合，覆盖 UI5、CAP、BTP、ABAP 等多类 SAP 文档，并提供公开的托管只读端点。对 SAP 开发者而言实用性强、无需凭证，但需注意其非 SAP 官方出品，且在线查询会将关键词发送至第三方来源；本条目仅描述 sap-docs 变体，不含仓库中 abap 变体的工具。
SAP Docs MCP Server 让 AI 助手（Claude、Cursor、ChatGPT 等）通过统一的检索与获取接口访问 SAP 文档。它结合本地离线全文与语义索引（基于 git 克隆的 SAP 文档语料）以及可选的在线查询（SAP Help、SAP Community、Software Heroes），全部以 MCP 工具形式暴露。搜索使用 BM25 关键词匹配与语义嵌入（Xenova/all-MiniLM-L6-v2）经 Reciprocal Rank Fusion 融合的混合检索。服务器公开、只读，无需 API 密钥或登录，并提供托管的 streamable HTTP 端点。该仓库同时包含另一个 abap 变体的 MCP 服务器，本条目仅描述 sap-docs 变体。
工具能力
search
对离线文档和可选在线来源进行统一的混合检索（BM25 + 语义），支持 query、k、includeOnline、includeSamples、abapFlavor、sources 参数。
fetch
根据 search 返回的 ID 获取完整文档内容。
abap_feature_matrix
使用 Software Heroes 特性矩阵检查 ABAP 特性在各 SAP 版本（7.40–LATEST）中的可用性。
sap_community_search
通过 Khoros LiQL API 进行专门的 SAP Community 检索，返回热门帖子的完整内容。
sap_search_objects
从官方 SAP/abap-atc-cr-cv-s4hc 发布状态仓库按名称、组件或类型检索 SAP 已发布对象（类、接口、表、CDS 视图等）。
sap_get_object_details
获取特定 SAP 对象的完整发布状态详情，包括 clean core 级别（A/B/C/D）、后继对象以及可选的合规判定。
sap_discovery_center_search
按关键词、类别或许可模式检索 SAP Discovery Center 服务目录中的 BTP 服务。
sap_discovery_center_service
获取 BTP 服务的详细信息：定价方案、产品路线图、文档链接和关键特性。接受服务 UUID 或名称。
ui5_version_diff
从本地 all-changes 集合中列出某个版本或版本区间内所有匹配的 FEATURE / FIX / DEPRECATED 变更和 SAPUI5 What's New 条目。
安装接入
方式一（托管端点，无需安装）：在支持 streamable HTTP 的 MCP 客户端中加入配置 {"mcpServers":{"sap-docs":{"type":"http","url":"https://mcp-sap-docs.marianzeis.de/mcp"}}}。方式二（本地 stdio）：克隆仓库后执行 npm ci、npm run setup、npm run build，然后运行 npm start 启动 stdio 模式；如需 streamable HTTP 可运行 npm run start:streamable（sap-docs 默认端口 3122）。也可通过 npm 包 mcp-sap-docs 以 stdio 传输方式使用。
claude_desktop_config.json
{"mcpServers":{"sap-docs":{"type":"http","url":"https://mcp-sap-docs.marianzeis.de/mcp"}}}
选型与风险
不适合谁
- 非 SAP 技术栈的通用文档检索
- 需要写入、修改或部署 SAP 系统的场景（该服务器为只读）
- 需要官方 SAP 支持或授权凭证的企业级支持场景
- 要求供应商官方维护保障的用户
所需权限
- 本地运行时需要网络访问以克隆文档子模块与可选在线查询（SAP Help、SAP Community、Software Heroes）
- 本地构建需要写入项目目录（索引数据库 docs.sqlite、dist/models 中的嵌入模型缓存约 90 MB）
- Docker 离线运行时可通过 --network none 完全禁用网络
- 托管端点无需 API 密钥或登录，访问为公开只读
风险与副作用
- 在线查询会把检索关键词发送到外部来源（SAP Help、SAP Community、Software Heroes）
- 本地索引与嵌入模型占用磁盘空间（模型约 90 MB，构建缓存较大）
- 构建时需克隆多个 SAP 文档仓库，耗时并依赖网络稳定性
- 该服务器由社区维护，非 SAP 官方产品，文档与行为可能随上游变化
常见排障
- 在线来源不可用时，在 search 请求中设置 includeOnline=false 以仅使用离线索引
- 若健康检查失败，检查端口是否正确：sap-docs 变体 HTTP 为 3001、streamable 为 3122
- 确认变体配置：MCP_VARIANT 环境变量或仓库根目录的 .mcp-variant 文件，未设置时回退为 sap-docs
- 本地无结果时，先执行 npm run setup 与 npm run build 以构建索引与嵌入
- 使用 --network none 时启动日志可能出现在线预取警告，但不影响离线检索
使用场景
查询 SAPUI5、OpenUI5、CAP、Cloud SDK、BTP、ABAP、Terraform Provider for BTP 等 SAP 文档
让 AI 助手以自然语言查找 SAP 文档内容（例如权限检查相关文档）
检索 SAP Community 的博客、问答与故障排查帖子
检查 ABAP 特性在特定 SAP 版本中的可用性
发现 SAP 已发布对象及其 clean core 发布状态
查询 SAP Discovery Center 中的 BTP 服务与定价方案
查看 SAPUI5 版本升级中的特性、修复与弃用变更
支持客户端
Claude完整支持
Cursor完整支持
ChatGPT完整支持