Cloud Alm Itsm MCP 伺服器 | PlugMCP跳到正文SAP Cloud ALM ITSM MCP Server
A Model Context Protocol (MCP) server for querying installations in SAP Cloud ALM ITSM API.
Features
- OAuth 2.0 Authentication: Automatically handles token requests and caching
- Installation Queries: Multiple query methods for flexible data retrieval
SAP Cloud ALM ITSM API MCP Server
- Get all installations with pagination
- Filter by system type (BTP, Public Cloud, etc.)
- Filter by customer number
- Filter by product name
- Full-text search across multiple fields
Prerequisites
- Node.js 18+
- TypeScript
- SAP Cloud ALM ITSM API credentials (client ID, client secret, endpoints)
Installation
-
Clone or navigate to the project directory:
cd cloud-alm-itsm-mcp
-
Install dependencies:
npm install
-
Create a .env file from the template:
cp .env.example .env
-
Update .env with your SAP Cloud ALM credentials:
cloud_alm_token_endpoint=https://your-tenant.authentication.eu10.hana.ondemand.com
cloud_alm_api=https://your-api-endpoint.eu10.alm.cloud.sap
cloud_alm_itsm_api_clientid=your_client_id
cloud_alm_itsm_api_clientsecret=your_client_secret
reporter=your_reporter_email
Building
Build the TypeScript code to JavaScript:
This creates compiled JavaScript files in the dist/ directory.
Running
Development Mode
For development with automatic TypeScript compilation:
Production Mode
Available Tools
1. get_installations
Retrieve installations from SAP Cloud ALM ITSM API with optional pagination.
offset (number, optional): Starting index for pagination (default: 0)
limit (number, optional): Maximum number of results (default: 50)
{
"offset": 0,
"limit": 50
}
2. get_installations_by_system_type
Filter installations by system type (e.g., BTP, Public Cloud).
system_type (string, required): The system type to filter by
offset (number, optional): Starting index (default: 0)
limit (number, optional): Maximum results (default: 50)
{
"system_type": "BTP",
"offset": 0,
"limit": 50
}
3. get_installations_by_customer
Filter installations by customer number.
customer_nbr (string, required): The customer number
offset (number, optional): Starting index (default: 0)
limit (number, optional): Maximum results (default: 50)
{
"customer_nbr": "0001801161",
"offset": 0,
"limit": 50
}
4. get_installations_by_product
Filter installations by product name.
product_txt (string, required): Product name to filter by
offset (number, optional): Starting index (default: 0)
limit (number, optional): Maximum results (default: 50)
{
"product_txt": "SAP HANA Cloud",
"offset": 0,
"limit": 50
}
5. search_installations
Full-text search across multiple fields (system name, customer, product, installation name, etc.).
query (string, required): Search query string
offset (number, optional): Starting index (default: 0)
limit (number, optional): Maximum results (default: 50)
{
"query": "BTP",
"offset": 0,
"limit": 50
}
MCP Client Configuration
To use this server with an MCP client (like Claude Desktop), add it to your client configuration:
Claude Desktop (.config/claude_desktop_config.json)
{
"mcpServers": {
"cloud-alm-itsm": {
"command": "node",
"args": ["/path/to/cloud-alm-itsm-mcp/dist/index.js"],
"env": {
"cloud_alm_token_endpoint": "https://your-tenant.authentication.eu10.hana.ondemand.com",
"cloud_alm_api": "https://your-api-endpoint.eu10.alm.cloud.sap",
"cloud_alm_itsm_api_clientid": "your_client_id",
"cloud_alm_itsm_api_clientsecret": "your_client_secret",
"reporter": "your_reporter_email"
}
}
}
}
Authentication Details
The server uses OAuth 2.0 with the client credentials flow:
- Token Request: Uses client ID and secret to obtain an access token
- Token Caching: Tokens are cached and automatically refreshed when expired (with a 5-minute buffer)
- API Requests: All API calls include the Bearer token in the Authorization header
Error Handling
The server includes comprehensive error handling:
- Token acquisition errors are caught and reported
- API errors include response details
- Missing required parameters are validated
- Network errors are handled gracefully
Response Format
All tools return JSON responses with the following structure:
For single installation queries:
{
"count": 50,
"totalCount": 202,
"results": [
{
"customerNbr": "...",
"productNbr": "...",
...
}
]
}
For filtered/search queries:
[
{
"customerNbr": "...",
"productNbr": "...",
...
}
]
Project Structure
cloud-alm-itsm-mcp/
├── src/
│ ├── index.ts # Main MCP server implementation
│ ├── auth.ts # OAuth 2.0 authentication client
│ ├── api.ts # SAP Cloud ALM ITSM API client
├── dist/ # Compiled JavaScript (generated)
├── tests/ # Test data and API examples
├── package.json
├── tsconfig.json
├── .env.example # Environment variables template
└── README.md # This file
Development
Type Safety
The project uses TypeScript with strict mode enabled for full type safety.
Dependencies
@modelcontextprotocol/sdk: MCP server implementation
axios: HTTP client for API requests
dotenv: Environment variable management
Troubleshooting
Token expires before token refresh
If you get authentication errors, ensure your OAuth client credentials are valid and the token endpoint is accessible.
API endpoint not responding
Check your .env configuration, particularly:
cloud_alm_api: Correct API endpoint URL
reporter: Valid reporter email for the API
Missing environment variables
Ensure all required variables are set in your .env file:
cloud_alm_token_endpoint
cloud_alm_api
cloud_alm_itsm_api_clientid
cloud_alm_itsm_api_clientsecret
reporter
License
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
如何安裝 Cloud Alm Itsm?
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
Cloud Alm Itsm 需要 API 金鑰嗎?
這筆記錄未列出必要的環境變數。
Cloud Alm Itsm 使用哪種傳輸方式?
Cloud Alm Itsm 透過 stdio 在本機執行。
Cloud Alm Itsm 上次檢查是什麼時候?
上次檢查時間:2026-10-28。 SAP Cloud ALM ITSM API MCP Server
azure-computeAzure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l 工具
0 / 10