Sap Cloud Alm Odata MCP

SAP云ALM MCP服务器

一个模型上下文协议（MCP）服务器，将SAP Cloud ALM API与Claude等AI助手连接起来。这允许与SAP Cloud ALM进行自然语言交互，以管理功能、文档、任务、项目、测试用例等。

特性

• 全面覆盖SAP云ALM API：访问9个不同的API，包括功能、文档、任务、项目、测试管理、流程层次结构、分析、流程监控和日志
• 两种身份验证模式:

- 生产环境的OAuth2客户端凭据 - SAP API Business Hub沙箱测试的静态API密钥

• 75+MCP工具：用于跨所有支持的API进行CRUD操作的全面工具集
• OData v4支持：带有$filter、$select、$expand、$orderby、$top、$skip的完整查询生成器
• 调试模式：用于故障排除的详细日志记录

先决条件

• 锈 （1.70或更高版本）- 安装Rust
• SAP云ALM访问：或者：

- 生产：服务绑定凭据（client_id、client_secret、租户、地区） - 沙盒：来自的API密钥 SAP API业务中心

安装

从源代码构建

# Clone and navigate to the project directory
git clone https://github.com/consetto/sap-cloud-alm-odata-mcp.git
cd sap-cloud-alm-odata-mcp

# Build the release binary
cargo build --release

# The binary will be at: ./target/release/sap-cloud-alm-mcp

配置

创建 config.json 项目目录中的文件（或指定一个自定义路径 --config).

选项A:OAuth2模式（生产）

要连接到您的SAP Cloud ALM租户：

{
  "tenant": "your-tenant-name",
  "region": "eu10",
  "client_id": "sb-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx!bxxxxx|calm!bxxxxx",
  "client_secret": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx=",
  "debug": false,
  "timeout_seconds": 30
}

领域：

选项B：沙盒模式（测试）

针对SAP API Business Hub沙箱进行测试：

{
  "sandbox": true,
  "api_key": "your-sap-sandbox-api-key",
  "debug": true,
  "timeout_seconds": 30
}

领域：

获取沙盒API密钥：

1. 访问 SAP API业务中心
2. 使用您的SAP帐户登录
3. 导航到任何SAP Cloud ALM API（例如，CALM_CDM_ODATA）
4. 单击“显示API密钥”以显示您的密钥

运行服务器

独立式（用于测试）

# With default config.json
./target/release/sap-cloud-alm-mcp

# With custom config file
./target/release/sap-cloud-alm-mcp --config /path/to/config.json

# With debug mode enabled
./target/release/sap-cloud-alm-mcp --debug

使用克劳德桌面

将服务器添加到您的Claude Desktop配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sap-cloud-alm": {
      "command": "/absolute/path/to/sap-cloud-alm-mcp",
      "args": ["--config", "/absolute/path/to/config.json"]
    }
  }
}

更新配置后，重新启动Claude Desktop。

配备MCP检查器（用于调试）

npx @modelcontextprotocol/inspector ./target/release/sap-cloud-alm-mcp --config config.json

可用工具

注： 标记有的工具⚠️ 实验性 是修改SAP Cloud ALM中数据的写入操作。这些工具在执行前需要明确的用户确认。

功能API（OData）

API文件（OData）

任务API（REST）

项目API（REST）

API测试管理（OData）

流程层次结构API（OData）

分析API（OData）

过程监控API（OData）

日志API（REST）

Claude使用示例

一旦配置了Claude Desktop，您就可以自然地进行交互：

"List all my SAP Cloud ALM projects"

"Show me the features in project XYZ"

"Create a new task in project ABC with title 'Fix login bug' and assign it to John"

"What are the open test cases for the current sprint?"

"Show me the process hierarchy for our S/4HANA implementation"

调试模式

启用调试模式进行故障排除：

1. 集 "debug": true 在config.json中，或
2. 使用 --debug 命令行标志

调试输出包括：

• 所有MCP消息（发送/接收）
• API请求和响应
• 身份验证流程详细信息
• 跟踪文件位于 /tmp/sap_calm_mcp_trace_{timestamp}.log

API终点

服务器连接到以下SAP Cloud ALM API：

生产URL模式: https://{tenant}.{region}.alm.cloud.sap 沙盒URL: https://sandbox.api.sap.com/SAPCALM

故障排除

身份验证错误

OAuth2模式：

• 验证您的client_id和client_secret是否正确
• 确保您的服务绑定具有所需的作用域
• 检查租户和地区是否与您的SAP Cloud ALM实例匹配

沙盒模式：

• 验证您的API密钥是否有效且未过期
• 检查沙盒模式是否已启用("sandbox": true)

连接问题

• 确保您的网络允许连接到SAP Cloud ALM端点
• 检查是否需要代理，并在操作系统级别进行配置
• 增加 timeout_seconds 用于慢速连接

调试提示

1. 启用调试模式以查看详细日志
2. 检查跟踪文件以获取完整的请求/响应详细信息
3. 使用MCP检查器交互式测试工具

许可证

MIT许可证

贡献

欢迎投稿！请确保您的代码：

• 构建无错误(cargo build)
• 通过所有测试(cargo test)
• 遵循Rust约定(cargo fmt 和 cargo clippy)

免责声明

本软件按“原样”提供，不提供任何明示或暗示的保证。

无责任

本工具的作者和贡献者对使用或误用本软件可能造成的任何损害、损失或后果不承担任何责任。这包括但不限于：

• 任何类型的数据丢失
• 系统、网络或数据的任何损坏
• 未经授权或不当使用造成的任何法律后果
• 任何业务损失或运营中断
• 任何安全事件或违规行为