Azsap MCP Typescript

🚀 Azure上でSAPのMCPサーバーを実行する（TypeScript実装）

このプロジェクトは、Azure環境でSAPを実行する際のModel Context Protocol (MCP) サーバーのTypeScript実装です。SAP HANAデータベース管理とAzureリソース管理のツールを提供します。

✨ 主な機能

• 複数の伝送方式：STDIO、HTTP、SSEの3つの伝送プロトコルをサポートします。
• 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

クライアントの使用

このパッケージには、MCPサーバーに接続できるクライアント実装が含まれています。

基本的な使用法

# ローカルの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コメントを参照してください。

テスト

# すべてのテストを実行する
npm test

# 特定のテストを実行する
npm test -- -t "system overview"

📄 ライセンス

MIT