UCloud MCP Server

 _    _ _____ _                 _ 
| |  | /  __ \ |               | |
| |  | | /  \/ | ___  _   _  __| |
| |  | | |   | |/ _ \| | | |/ _` |
| |__| | \__/\ | (_) | |_| | (_| |
 \____/ \____/_|\___/ \__,_|\__,_|
                                  
 __  __  _____ _____   _____                          
|  \/  |/  __ \  __ \ /  ___|                         
| .  . || /  \/| |_/ / \ `--.  ___ _ ____   _____ _ __
| |\/| || |    |  __/   `--. \/ _ \ '__\ \ / / _ \ '__|
| |  | || \__/\| |     /\__/ /  __/ |   \ V /  __/ |   
\_|  |_/ \____/\_|     \____/ \___|_|    \_/ \___|_|   

UCloud MCP サーバー

MCP-Go と UCloud SDK に基づくクラウドインスタンス管理サーバーです。MCP プロトコルを通じて UCloud インスタンスを管理できます。

機能

• インスタンス情報の照会
• すべてのインスタンスの一覧表示
• インスタンスのステータス取得
• インスタンスのパフォーマンス指標の監視
• MCP プロトコルのサポート
• 設定ファイルのサポート

要件

• Go 1.23 以降
• UCloud アカウントと API 認証情報

設定

このサービスでは、次の 2 つの設定方法を利用できます。

1. 設定ファイル（推奨）

config.json ファイルを作成します。

{
    "region": "cn-bj2",
    "project_id": "your-project-id",
    "public_key": "your-public-key",
    "private_key": "your-private-key"
}

2. 環境変数

設定ファイルで指定されていない場合、サービスは環境変数からの読み込みを試みます。

export UCLOUD_REGION="cn-bj2"        # UCloud region
export UCLOUD_PROJECT_ID="your-project-id"  # Project ID
export UCLOUD_PUBLIC_KEY="your-public-key"  # API public key
export UCLOUD_PRIVATE_KEY="your-private-key"  # API private key

設定の優先順位：設定ファイル > 環境変数

インストールと実行

1. リポジトリをクローンします。

git clone https://github.com/renzheng.wang/ucloud-mcp-server.git
cd ucloud-mcp-server

2. 依存関係をインストールします。

go mod download

3. サービスをビルドします。

go build -o ucloud-mcp-server

4. サービスを実行します。

基本的な使い方：

./ucloud-mcp-server

カスタム設定を使用する場合：

./ucloud-mcp-server --config /path/to/config.json --port 8080

利用可能な起動オプション：

• --config：設定ファイルのパスを指定します（デフォルト：./config.json）
• --port：リッスンするポートを指定します（デフォルト：8080）

例：

# Use custom config file
./ucloud-mcp-server --config /etc/ucloud/config.json

# Use custom port
./ucloud-mcp-server --port 9000

# Use both custom config and port
./ucloud-mcp-server --config /etc/ucloud/config.json --port 9000

このサービスは、標準入出力を通じて MCP プロトコルのサービスを提供します。

利用可能な操作

インスタンス情報

特定のインスタンスの詳細情報を取得します。次の情報が含まれます。

• インスタンスの基本情報
• 設定情報
• 現在のステータス
• リソース割り当て

インスタンスのステータス

任意のインスタンスの現在の稼働ステータスをリアルタイムで監視します。

インスタンスの指標

インスタンスの包括的な監視指標にアクセスできます。次の項目が含まれます。

• CPU 使用率
• ディスク I/O 操作
• ネットワークトラフィックの統計
• システムパフォーマンスデータ

インスタンス一覧

アカウントで利用可能なすべてのインスタンスと、それぞれの基本情報および現在のステータスを一覧表示します。

監視指標

システムは次の監視指標を提供します。

• CPU 指標

  • CPUUtilization：CPU 使用率（%）

• ディスク指標

  • IORead：ディスク読み取り速度
  • IOWrite：ディスク書き込み速度
  • DiskReadOps：ディスク読み取り操作数
  • DiskWriteOps：ディスク書き込み操作数

• ネットワーク指標

  • NICIn：ネットワーク受信トラフィック（バイト/秒）
  • NICOut：ネットワーク送信トラフィック（バイト/秒）
  • NetPacketIn：ネットワーク受信パケット数
  • NetPacketOut：ネットワーク送信パケット数

重要な注意事項

• UCloud API 認証情報は安全に保管してください。
• 本番環境で機密情報を扱う場合は、設定ファイルまたはキー管理サービスを使用してください。
• すべての操作は、標準 I/O に対応した MCP プロトコルを通じて実行されます。
• 監視データの反映には数分の遅延が生じる場合があります。
• 潜在的な問題を早期に特定するため、監視指標を定期的に確認してください。