Azsap MCP Typescript

🚀 在Azure上運行SAP的MCP服務器（TypeScript實現）

這是在Azure環境中運行SAP時的一種Model Context Protocol (MCP) 服務器的TypeScript實現。它提供了對SAP HANA數據庫管理和Azure資源管理的工具，能有效助力相關業務的開展。

✨ 主要特性

• 多種傳輸方式：支持STDIO、HTTP和SSE三種傳輸協議，可滿足不同場景的傳輸需求。
• SAP HANA集成：提供查詢和管理SAP HANA數據庫的工具，方便對數據庫進行操作。
• Azure虛擬機管理：提供對Azure虛擬機的啟動、停止和狀態檢查功能，實現對虛擬機的有效管控。
• 網絡安全組操作：提供對Network Security Group（NSG）的管理工具，增強網絡安全性。
• 資源監控：提供對系統資源的跟蹤工具，有助於即時掌握系統資源使用情況。
• TypeScript實現：採用現代ECMAScript特性，完全基於類型定義的實現，提升代碼的可維護性和可讀性。

📦 安裝指南

# 克隆倉庫
git clone <repository-url>
cd azsap-mcp-typescript

# 安裝依賴項
npm install

# 配置環境
cp .env.example .env
# 根據提示編輯.env文件，輸入SAP HANA和Azure的憑證信息

# 構建項目
npm run build

💻 使用示例

基礎用法

運行服務器

STDIO傳輸（用於Claude Desktop）

npm start

HTTP傳輸（用於Web客戶端）

npm run start:http

或者指定自定義主機和端口：

node dist/server-cli.js --transport http --host localhost --port 3000

使用客戶端

# 連接到本地STDIO服務器
npm run client -- --transport stdio --command "node" --args "dist/server-cli.js"

# 連接到HTTP服務器
npm run client -- --transport http --host localhost --port 3000

# 執行特定工具
npm run client -- --transport http --host localhost --port 3000 --tool get_system_overview

作為庫使用

import { createServer, connectServer, AzureMCPClient } from 'azsap-mcp-typescript';

// 創建並啟動一個服務器
const server = createServer();
await connectServer(server, 'stdio');

// 或者使用客戶端
const client = new AzureMCPClient();
await client.connect('localhost', 3000);
await client.execute('get_system_overview');

高級用法

目前暫無高級用法的相關內容，若有需要可根據實際情況進行拓展。

📚 詳細文檔

有關可用工具及其參數的更多信息，請參閱源代碼和JSDoc註釋。

🔧 技術細節

項目結構如下：

- azsap-mcp-typescript/
  - src/
    - Server.ts              # MCP服務器實現
    - Client.ts              # MCP客戶端實現
    - tools/
      - systemOverview.ts    # 系統概覽工具
      - diskUsage.ts         # 磁盤使用情況工具
      - vmManagement.ts      # 虛擬機管理工具
  - package.json            # 項目依賴和腳本配置
  - README.md               # 項目文檔

📄 許可證

本項目採用MIT許可證。

🔧 測試

# 運行所有測試
npm test

# 運行特定測試
npm test -- -t "system overview"