SAP BTP文档MCP服务器
模型上下文协议(MCP)服务器,提供语义搜索和对SAP业务技术平台(BTP)文档的智能访问。
概述
此MCP服务器使Claude等AI助手能够高效地搜索、检索和理解SAP BTP文档。它在整个BTP文档存储库中提供语义搜索功能。
特性
- 语义搜索:智能搜索所有SAP BTP文档
- 类别筛选:在特定领域内搜索(开发、管理、集成、安全)
- 文档检索:获取包含目录的完整文档页面
- 服务特定文档:快速访问特定BTP服务的文档
- 相关性评分:按与查询的相关性对结果进行排名
安装
先决条件
- Node.js 20.0.0或更高版本
- npm或纱线
快速开始
- 克隆此存储库:
git clone
cd dlwr-dnl-btp-documentation-mcp- 安装依赖项:
source ~/.zshrc && nvm use
npm install- 构建服务器:
npm run build- SAP BTP文档将在首次构建期间自动克隆(位于
docs/sap-btp-docs/)
配置
克劳德桌面
添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"sap-btp-docs": {
"command": "node",
"args": [
"/absolute/path/to/dlwr-dnl-btp-documentation-mcp/build/index.js"
]
}
}
}自定义文档路径
要使用其他文档位置:
{
"mcpServers": {
"sap-btp-docs": {
"command": "node",
"args": [
"/absolute/path/to/dlwr-dnl-btp-documentation-mcp/build/index.js"
],
"env": {
"SAP_BTP_DOCS_PATH": "/path/to/custom/docs"
}
}
}
}可用工具
1.搜索_btp_docs
语义搜索SAP BTP文档。
参数:
query(必填):搜索查询字符串service_area(可选):按区域筛选(“全部”、“开发”、“管理”、“集成”、“安全”)limit(可选):最大结果(1-50,默认值:10)
例子:
Search for "Cloud Foundry deployment best practices"2.get_btp_document
检索特定文档页面的完整内容。
参数:
path(必填):文档的相对路径(来自搜索结果)
例子:
Get document at path "docs/30-development/deploy-app.md"3.获取服务文档
获取特定SAP BTP服务的全面文档。
参数:
service_name(必填):BTP服务的名称
例子:
Get documentation for "SAP HANA Cloud"4.列表_btp_类别
列出所有可用的文档类别和顶级文档。
例子:
Show all available documentation categories发展
项目结构
dlwr-dnl-btp-documentation-mcp/
├── src/
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server implementation
│ ├── types/
│ │ └── index.ts # TypeScript type definitions
│ ├── indexer/
│ │ ├── markdown-parser.ts # Markdown document parser
│ │ └── document-index.ts # Document indexing & search
│ └── tools/
│ ├── search.ts # Search tool implementation
│ ├── get-document.ts # Document retrieval tool
│ ├── get-service.ts # Service documentation tool
│ └── list-categories.ts # Category listing tool
├── docs/
│ └── sap-btp-docs/ # SAP BTP documentation (cloned)
├── build/ # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md构建命令
# Build once
npm run build
# Build and watch for changes
npm run watch
# Run the server directly
npm run dev测试
使用MCP检查器测试服务器:
npx @modelcontextprotocol/inspector node build/index.js建筑
文献检索
服务器在启动时对SAP BTP文档存储库中的所有markdown文件进行索引:
- 解析:用途
unified和remark用frontmatter解析markdown - 提取:提取元数据、标题、章节和关键字
- 索引:使用Fuse.js创建可搜索索引进行模糊语义搜索
- 分类:根据文件夹结构自动对文档进行分类
搜索策略
- 多字段搜索:在标题、标题、内容和关键字之间进行搜索
- 加权评分:标题和关键字的权重高于内容
- 模糊匹配:处理拼写错误和部分匹配
- 上下文提取:返回匹配术语的相关摘录
用例
德莱维荷兰队
- 快速参考:在客户参与期间即时访问BTP文档
- 训练:支持DI AI项目培训和启用
- 解决方案设计:研究整合模式和最佳做法
- 故障排除:为特定的BTP问题找到解决方案
人工智能代理(ConnectedBrain 2.0)
- 语义模块:作为知识模块集成到多代理编排中
- 上下文提供程序:为解决方案生成提供BTP特定上下文
- 代码助手:帮助生成符合BTP的代码和配置
演出
- 初始索引构建:~5-10秒(取决于文档大小)
- 搜索查询:\<100ms(内存搜索)
- 内存使用:~50-100MB(索引文档)
路线图
第2阶段增强功能
- 改进语义搜索的向量嵌入
- 代码样本提取和索引
- 集成模式识别
- 文档的自动更新机制
第3阶段高级功能
- 服务关系图数据库
- 频繁访问文档的上下文缓存
- 与SAP帮助门户集成
- 多语言支持
贡献
这是德莱维荷兰的内部工具。如有疑问或意见,请联系数据与人工智能团队。
许可证
MIT许可证-德莱维荷兰内部使用
支持
对于问题或疑问:
- 内部:德莱维荷兰数据与人工智能团队
- 文档: SAP BTP官方文档
______________________________________________________________________
内置于❤️ 德莱维荷兰数据与人工智能团队
*我们“平台优先,云原生”AI赋能运营计划的一部分*
