Sap Btp Usage MCP Server

SAP BTP使用MCP服务器

使用自然语言讨论您的SAP BTP成本！此MCP服务器允许AI助手（如SAP Joule）回答有关云消费的问题。

你可以问的例子：

• *“我们还剩下多少云积分？”*
• *“这个月哪些服务最贵？”*
• *“比较我们的支出：一月与二月”*
• *“有超过配额的服务吗？”*

______________________________________________________________________

快速开始

# 1. Clone and enter the project
git clone https://github.com/ADS-Eng-TI-Cloud-Computing/sap-btp-usage-mcp-server.git
cd sap-btp-usage-mcp-server

# 2. Login to Cloud Foundry
cf login -a https://api.cf..hana.ondemand.com

# 3. Create required services
cf create-service xsuaa application sap-btp-usage-xsuaa -c xs-security.json
cf create-service destination lite sap-btp-usage-destination

# 4. Build and deploy
npm install && npm run build
cf push

# 5. Test it
curl https:///health

然后在BTP驾驶舱中配置目的地（见下面的详细步骤）。

______________________________________________________________________

工作原理（简单版）

┌──────────────┐         ┌──────────────┐         ┌──────────────┐
│   You ask    │   ───►  │  MCP Server  │   ───►  │  SAP BTP     │
│   Joule      │         │  (this app)  │         │  Usage API   │
└──────────────┘         └──────────────┘         └──────────────┘
     "How many               Validates              Returns real
   credits left?"            & fetches               usage data

image

用简单的英语：

1. 你问Joule一个关于BTP成本的问题
2. Joule用您的问题呼叫此MCP服务器
3. MCP服务器从SAP的Usage API获取数据
4. 你会得到一个自然语言的答案

安全： 所有请求都通过XSUAA使用OAuth2/JWT令牌进行身份验证。

______________________________________________________________________

你可以问什么问题？

______________________________________________________________________

开始之前

您需要：

• Node.js 18+ — 下载
• Cloud Foundry命令行界面 — 下载
• SAP BTP帐户 启用Cloud Foundry
• 权利： XSUAA（应用计划）+目的地（精简计划）

______________________________________________________________________

第1部分：部署MCP服务器

第一步：克隆项目

git clone https://github.com/ADS-Eng-TI-Cloud-Computing/sap-btp-usage-mcp-server.git
cd sap-btp-usage-mcp-server

第二步：登录Cloud Foundry

cf login -a https://api.cf..hana.ondemand.com

替换 ` 与您所在的地区： us10, eu10, br10`等等。

步骤3：创建服务

# Security service (authenticates requests)
cf create-service xsuaa application sap-btp-usage-xsuaa -c xs-security.json

# Destination service (connects to SAP APIs)
cf create-service destination lite sap-btp-usage-destination

步骤4：构建和部署

npm install
npm run build
cf push

步骤5：验证它是否正在运行

# Check app status
cf apps

# Test health endpoint
curl https:///health
# Expected: {"status":"healthy","server":"sap-btp-usage-mcp-server"}

______________________________________________________________________

第2部分：配置用法API目标

MCP服务器需要连接到SAP的Usage API。在中设置此项 BTP驾驶舱:

1. 首选 您的子帐户 → 连接性 → 目的地
2. 点击 新目的地
3. 填写：

1. 点击 保存 → 检查连接

📖 需要UAS证书吗？看 SAP BTP资源消耗API

______________________________________________________________________

第3部分：连接到SAP Joule Studio

现在让我们告诉Joule如何找到您的MCP服务器。

第一步：获取您的证书

# Create and view the service key
cf create-service-key sap-btp-usage-xsuaa joule-key
cf service-key sap-btp-usage-xsuaa joule-key

保存这些值： clientid, clientsecret, url

步骤2：获取您的应用程序URL

cf app sap-btp-usage-mcp-server | grep routes

步骤3：创建焦耳目标

在 BTP驾驶舱 （在Joule Studio的子账户中）：

1. 首选 连接性 → 目的地
2. 点击 新目的地
3. 填写：

步骤4：添加魔术属性⚠️

点击 新财产 并添加：

此属性是必需的！ 没有它，Joule将无法发现您的MCP服务器。

步骤5：保存并测试目标

点击 保存 → 检查连接

✅ 目的地已经准备好了。现在在Joule Studio中创建代理。

______________________________________________________________________

步骤6：在SAP构建大厅中创建项目

1. 打开 SAP构建大厅.

Open Lobby

1. 选择 焦耳试剂与技巧.

Select Joule Agent and Skill

1. 输入项目的名称。

Enter project name

1. 点击 创建.

Click Create

______________________________________________________________________

步骤7：在项目内部创建代理

1. 在新项目中，单击 创建代理.

Create Agent

1. 填写 名字 和 描述 领域。

Fill Name and Description

1. 填写 专长 和 说明 领域。

Fill Expertise and Instructions

______________________________________________________________________

步骤8：将MCP服务器添加到代理中

1. 点击 添加MCP服务器.

Add MCP Server

1. 填写MCP服务器详细信息，并选择在步骤3中创建的目标。

Fill MCP Server details

1. 点击 添加服务器那么 保存.

Add Server and Save

1. 向代理添加其他工具：

- 点击 添加工具. - 选择 计算器 从可用工具列表中。 - 点击 添加 以确认。

> 这允许代理在分析成本数据时执行计算。

______________________________________________________________________

步骤9：测试代理

1. 点击 测试 打开测试面板。

Test panel

1. 问你的代理人一个问题，例如：

Ask a question

> *“本月哪5项服务消耗的积分最多？”*

✅ 完成！您的Joule代理现在已连接到BTP Usage MCP服务器。

______________________________________________________________________

代理说明

复制下面的文本并将其粘贴到 说明 在配置代理时输入字段（步骤7）。

______________________________________________________________________

SAP BTP使用情况分析师

目的

此代理可帮助用户使用使用数据管理API中的实时数据来监控和分析SAP BTP全球帐户的使用情况。

工具

如有必要，您可以使用计算器工具来支持您的计算。

你可以问什么

可用工具

指南

• 在比较数据时，始终指定时间段。
• 使用 top 列出顶级消费者时的参数（默认值：5）。
• 对于成本明细，请指定 groupBy: service, subaccount，或 datacenter.
• 所有数据均来自SAP BTP Usage data Management API实时数据管理。

交互示例

用户： “我们还剩多少学分？” 代理人： 呼叫 sap_btp_get_cloud_credits → 返回余额、到期和阶段信息。

用户： “哪些服务超出预算？” 代理人： 呼叫 sap_btp_check_overusage → 返回超出配额的服务列表。

用户： “比较12月与1月的支出” 代理人： 呼叫 sap_btp_compare_months 有几个月 2025-12 和 2026-01 → 返回一个比较表。

______________________________________________________________________

地方发展（可选）

想在您的计算机上运行服务器进行测试吗？

第一步：创建 default-env.json

从Cloud Foundry服务复制凭据：

cf service-key sap-btp-usage-xsuaa local-key
cf service-key sap-btp-usage-destination local-key

创建 default-env.json (⚠️ 永远不要提交此文件):

{
  "VCAP_SERVICES": {
    "xsuaa": [{
      "label": "xsuaa",
      "name": "sap-btp-usage-xsuaa",
      "credentials": {
        "clientid": "...",
        "clientsecret": "...",
        "url": "https://..."
      }
    }],
    "destination": [{
      "label": "destination",
      "name": "sap-btp-usage-destination",
      "credentials": {
        "clientid": "...",
        "clientsecret": "...",
        "uri": "...",
        "url": "..."
      }
    }]
  }
}

第二步：在本地运行

# With authentication (production-like)
npm run local

# Without authentication (easier for testing)
AUTH_ENABLED=false npm run local

服务器运行于 http://localhost:3000

______________________________________________________________________

API终点

______________________________________________________________________

故障排除

“连接被拒绝”或“401未经授权”

• 检查应用程序是否正在运行： cf apps
• 验证目标凭据是否与服务密钥匹配

“找不到目标”

• 确保 SAP_BTP_USAGE_API BTP驾驶舱中存在目的地
• 检查目标名称是否准确（区分大小写）

Joule看不到MCP服务器

• 验证 sap-joule-studio-mcp-server: true 属性已设置
• 确保目的地在 同一子账户 作为焦耳工作室

检查日志

cf logs sap-btp-usage-mcp-server --recent

______________________________________________________________________

项目结构

sap-btp-usage-mcp-server/
├── src/
│   ├── auth/          # JWT validation & XSUAA
│   ├── schemas/       # Input validation (Zod)
│   ├── services/      # SAP BTP Usage API client
│   ├── tools/         # MCP tool definitions
│   └── index.ts       # Main entry point
├── manifest.yaml      # CF deployment config
├── xs-security.json   # XSUAA scopes & roles
└── package.json

______________________________________________________________________

了解更多

• SAP BTP使用API -API文件
• 模型上下文协议 --MCP规范
• SAP焦耳 --AI助理文档