SAP Docs MCP Server

社区

面向 SAP 文档的统一混合检索 MCP 服务器，无需 API 密钥。

分类: 开发工具第 50 / 438
Stars: ★ 249 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: 远程托管（无需本地环境） · Node.js · Docker
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 9 天前
工具数: 9

65FMRS · C

这是一个社区维护的 SAP 文档检索 MCP 服务器，将 BM25 关键词检索与语义嵌入检索融合，覆盖 UI5、CAP、BTP、ABAP 等多类 SAP 文档，并提供公开的托管只读端点。对 SAP 开发者而言实用性强、无需凭证，但需注意其非 SAP 官方出品，且在线查询会将关键词发送至第三方来源；本条目仅描述 sap-docs 变体，不含仓库中 abap 变体的工具。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

14/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README 描述了统一的 search/fetch 工具、混合 BM25+语义检索、RRF 融合、离线/在线模式及健康检查端点(/health,/status)，并列出多种验证命令(test:integration、test:discovery-center 等)，说明关键路径设计清晰。但本次为纯静态审阅，未执行任何代码；仓库中虽有 CI/同步工作流与测试脚本名称，但无法确认测试覆盖 MCP 初始化、工具清单握手与错误路径。此外同一仓库含两个变体(server.json 仅对应 sap-docs 变体)，共享代码增加了行为歧义(docs 与 abap 变体混排)。故按静态校准上限及证据缺失扣分，得 10。
安全与权限 12/20: 该服务器为公开只读文档检索，无需 API key，工具(search/fetch/abap_feature_matrix 等)语义上不产生破坏性副作用；Docker 文档提供 `--network none` 与 includeOnline=false 实现离线隔离，边界披露较好。但默认启用在线来源(SAP Help/Community/Software Heroes)会向外部发起查询，README 未明确说明将用户查询内容发送至第三方的数据流向与隐私影响；同步工作流依赖 ABAP_REPO_SYNC_TOKEN 跨仓库 push，属敏感凭据，文档未说明最小权限范围或轮换策略。未发现红线(无恶意、无窃取凭据、无不可逆默认操作)，故不判 0-4，但因数据流向披露与凭据范围说明不完整，扣分至 12。
维护活跃度 14/20: Apache-2.0 许可明确，版本号 0.3.15 且使用 Release Please 做版本发布，说明有清晰发布流程；README 描述了双向无关的单向同步、部署模型与 PM2 运行时，治理结构相对完整，issues 为 0。但静态材料未提供近期提交时间线、依赖更新策略或安全响应渠道(CVE/披露流程)的说明，无法佐证持续维护强度。按可见证据给 14，因安全响应渠道与依赖更新机制未披露而扣分。
文档质量 15/20: 文档分层较好：Install、公共托管端点、变体差异表、离线/在线来源表、工具清单与参数(search 支持 query/k/includeOnline/includeSamples/abapFlavor/sources)、Docker、BTP CF、PM2、验证命令及指向 docs/ARCHITECTURE.md、HYBRID-SEARCH.md 等的链式引用，并披露了嵌入模型(~90MB)与端口差异。扣分点：工具参数的完整 JSON schema、错误返回格式与限流/成本说明缺失；README 混合描述两个变体的工具，易使读者误把 abap_lint 等归到本 server.json 对应的 sap-docs 变体上，存在能力归属歧义。得 15。
安装易用性 14/20: 提供多路径安装：一键 Werkbank 徽章、streamable HTTP 客户端 JSON 配置、npm ci/setup/build/start 本地流程、Docker 镜像构建与运行示例、BTP CF 部署指引，且给出默认端口与健康检查命令，主线路径清晰、步骤较少。扣分：本地运行需先 setup 拉取 git 子模块并构建 FTS 与 90MB 嵌入模型，首次准备较重且对网络/磁盘有隐性要求；仓库含两个变体，用户须自行通过 MCP_VARIANT 区分，配置略增复杂度。按静态校准(未执行)上限 15 内给 14。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 SAPUI5、CAP、BTP、ABAP 等技术的 SAP 开发者
希望在编辑器或 AI 助手中直接检索 SAP 官方与社区文档的团队
需要离线或受限网络环境下本地索引检索的场景
关注 clean core 合规与 SAP 已发布对象状态的开发者

不适合谁

非 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 官方产品，文档与行为可能随上游变化

安装接入

准备工作

运行环境：远程托管（无需本地环境） · Node.js · Docker

其他可选配置项（3 个）

MCP_VARIANT 可选选择服务器变体（sap-docs 或 abap），未设置时默认为 sap-docs。

MCP_PORT 可选指定 HTTP 监听端口，Docker 示例中使用 3122。

MCP_HOST 可选指定监听地址，Docker 中设为 0.0.0.0 以便从宿主机访问。

方式一（托管端点，无需安装）：在支持 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 传输方式使用。

.cursor/mcp.json

{"mcpServers":{"sap-docs":{"type":"http","url":"https://mcp-sap-docs.marianzeis.de/mcp"}}}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "sap-docs": {
      "type": "http",
      "url": "https://mcp-sap-docs.marianzeis.de/mcp"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http sap-docs https://mcp-sap-docs.marianzeis.de/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中添加 https://mcp-sap-docs.marianzeis.de/mcp 端点后，工具列表应出现 search、fetch 等工具；也可以用 curl 访问 http://127.0.0.1:3122/health 验证本地部署。

常见排障

在线来源不可用时，在 search 请求中设置 includeOnline=false 以仅使用离线索引
若健康检查失败，检查端口是否正确：sap-docs 变体 HTTP 为 3001、streamable 为 3122
确认变体配置：MCP_VARIANT 环境变量或仓库根目录的 .mcp-variant 文件，未设置时回退为 sap-docs
本地无结果时，先执行 npm run setup 与 npm run build 以构建索引与嵌入
使用 --network none 时启动日志可能出现在线预取警告，但不影响离线检索

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索 SAP 文档：RAP draft 的用法是什么？
查询 ABAP feature matrix：7.50 支持哪些新语法特性？
对比 SAPUI5 1.120 和 1.124 之间的版本变更。
在 SAP Community 中搜索关于 OData V4 错误的解决方案。

工具能力 9

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 或名称。

展开其余 1 个工具

ui5_version_diff 只读

从本地 all-changes 集合中列出某个版本或版本区间内所有匹配的 FEATURE / FIX / DEPRECATED 变更和 SAPUI5 What's New 条目。

使用场景

查询 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

依据项目文档列出，未经本站实测。

详细介绍

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 变体。