Rtc MCP Server

🚀 アリババクラウドリアルタイムコンピューティング MCP サーバー

このサーバーは、アリババクラウドリアルタイムコンピューティング（Realtime Compute）の Apache Flink リソースを管理する Model Context Protocol (MCP) サーバーの実装です。AI モデルと Alibaba Cloud Flink サービスのやり取りに標準化されたインターフェースを提供します。

✨ 主な機能

• Flink クラスターの作成と管理
• Flink SQL タスクの作成と管理
• Flink アプリケーションのデプロイと制御
• タスクの状態と指標の監視
• スナップショットポイントの作成と管理
• デプロイの一覧表示と管理
• ワークスペースと名前空間の管理

📦 インストール

前提条件

• JDK 17 以上
• Maven 3.6 以上
• Alibaba Cloud アクセス権限を持つ阿里云アカウント（RTC リアルタイムコンピューティングサービス権限が必要）
• アリババクラウドアクセスキー ID とシークレット

クライアント設定

このサーバーを MCP クライアントとして使用するには、MCP 設定ファイル（例: cline_mcp_settings.json）に以下の設定を追加してください。

{
  "mcpServers": {
    "rtc-mcp-server": {
      "command": "java",
      "args": [
        "-Dtransport.mode=stdio",
        "-Dspring.main.web-application-type=none",
        "-Dspring.main.banner-mode=off",
        "-Dlogging.file.name=/path/to/rtc-mcp-server/mcpserver.log",
        "-jar",
        "/path/to/rtc-mcp-server/target/rtc-mcp-server-1.0-SNAPSHOT.jar"
      ],
      "env": {
        "ALIYUN_ACCESS_KEY_ID": "your-access-key-id",
        "ALIYUN_ACCESS_KEY_SECRET": "your-access-key-secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

/path/to/rtc-mcp-server を実際のサーバーパスに置き換え、環境変数に阿里云の認証情報を設定してください。

💻 使用例

利用可能なツール

このサーバーは以下の MCP ツールを提供します。

タスク管理

• start_job: デプロイされた Flink タスクを開始します。
• stop_job: 実行中の Flink タスクを停止します。
• list_jobs: デプロイされているすべてのタスクを一覧表示します。
• delete_job: 実行中でないタスクを削除します。
• get_job_diagnosis: タスクの診断情報を取得します。

デプロイ管理

• create_deployment: 新しいデプロイを作成します。
• update_deployment: 既存のデプロイを更新します。
• delete_deployment: 指定されたデプロイを削除します。
• list_deployments: すべてのデプロイを一覧表示します。
• get_deployment_status: 特定のデプロイの状態を取得します。

ワークスペース管理

• create_workspace: 新しいワークスペースを作成します。
• update_workspace: 既存のワークスペースの設定を更新します。
• delete_workspace: 指定されたワークスペースを削除します。
• list_workspaces: すべてのワークスペースを一覧表示します。
• get_workspace_info: 特定のワークスペースの情報を取得します。

リソース管理

• allocate_resources: 計算リソースを申請します。
• release_resources: 割り当てられたリソースを解放します。
• modify_resource_limits: リソース制限を調整します。
• view_resource_usage: リソースの使用状況を確認します。

ビルドと実行

プロジェクトのビルド

mvn clean package

サーバーの実行

java -jar target/rtc-mcp-server-1.0-SNAPSHOT.jar

📚 詳細ドキュメント

サーバーモード

• 標準モード: 完全な機能を提供し、本番環境での使用に適しています。
• 開発モード: デバッグ機能が強化され、開発とテスト段階での使用に適しています。

ログ記録

デフォルトでは、ログは mcpserver.log ファイルに出力されます。以下の設定で調整できます。

logging.file.name=/path/to/log/mcpserver.log
logging.level=INFO

🤝 コントリビューションガイド

コミュニティからの貢献を歓迎します！開発への参加方法やコードの提出方法については、プロジェクトドキュメントを参照してください。

📄 ライセンス

このプロジェクトは Apache License 2.0 に従います。詳細は以下の通りです。

適用される法律または書面による同意がない限り、上記のライセンスに基づき、ソフトウェアとそのドキュメントはすべての状況で無料で使用できます。