Ucloud MCP Server

🚀 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 リージョン
export UCLOUD_PROJECT_ID="your-project-id"  # プロジェクト ID
export UCLOUD_PUBLIC_KEY="your-public-key"  # API 公開鍵
export UCLOUD_PRIVATE_KEY="your-private-key"  # API 秘密鍵

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

インストールと実行

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）

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

💻 使用例

インスタンス情報

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

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

インスタンス状態

任意のインスタンスの現在の実行状態をリアルタイムで監視します。

インスタンス指標

包括的なインスタンス監視指標にアクセスします。以下の指標が含まれます。

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

インスタンスリスト

あなたのアカウント下のすべての利用可能なインスタンスの完全なリストを表示し、基本情報と現在の状態を確認できます。

🔧 技術詳細

監視指標

• 数分の遅延が発生する可能性があります。
• 潜在的な問題を早期に発見するために、定期的に監視指標を確認してください。