Console MCP Server

🚀 Mia-PlatformコンソールMCPサーバー

Mia-PlatformコンソールMCPサーバーは、モデルコンテキストプロトコル（MCP）サーバーです。Mia-PlatformコンソールAPIとのシームレスな統合を提供し、開発者やツールが高度な自動化とインタラクション機能を実現できるようにします。

🚀 クイックスタート

前提条件

1. コンテナ内でサーバーを実行するには、Dockerをインストールする必要があります。
2. Dockerをインストールしたら、Dockerが実行中であることを確認してください。
3. 最後に、Mia-Platformサービスアカウントを作成する必要があります。現在サポートされている唯一の認証方法はクライアントシークレット基本です。

インストール

VS Code

手動インストールの場合は、ユーザー設定（JSON）ファイルに以下のJSONブロックを追加します。Ctrl + Shift + Pを押して設定：ユーザー設定（JSON）を開くと入力することで実行できます。また、ワークスペース内の.vscode/mcp.jsonファイルに追加することもできます。

追加が完了したら、プロキシモード（Copilotチャットのテキスト入力の横にあります）を切り替えると、サーバーが起動します。

⚠️ 重要提示

.vscode/mcp.jsonファイルではmcpキーは必要ありません。

また、コンソールインスタンスのホストを独自のインストールに変更することもできます。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "mia_client_id",
        "description": "Mia-PlatformクライアントID",
        "password": false
      },
      {
        "type": "promptString",
        "id": "mia_client_secret",
        "description": "Mia-Platformクライアントシークレット",
        "password": true
      },
    ],
    "servers": {
      "mia-platform-console": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "MIA_PLATFORM_CLIENT_ID",
          "-e",
          "MIA_PLATFORM_CLIENT_SECRET",
          "ghcr.io/mia-platform/console-mcp-server",
          "https://docs.mia-platform.eu/docs/development_suite/identity-and-access-management/manage-service-accounts"
        ],
      }
    }
  }
}

Claude Desktop

Claude Desktopでは、mcp.jsonファイルに以下の内容を直接追加できます。

{
  "mia-platform-console": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "MIA_PLATFORM_CLIENT_ID=${INPUT}",
      "-e",
      "MIA_PLATFORM_CLIENT_SECRET=${INPUT_SEC}",
      "ghcr.io/mia-platform/console-mcp-server"
    ],
    "env": {
      "MIA_PLATFORM_CLIENT_ID": {
        "description": "あなたのMia-PlatformクライアントID",
        "required": true
      },
      "MIA_PLATFORM_CLIENT_SECRET": {
        "description": "あなたのMia-Platformクライアントシークレット",
        "required": true
      }
    }
  }
}

ローカル開発

サーバーを実行するには、以下のコマンドを使用します。

npm install

新しい実装をデバッグする際には、ローカルでテスト環境を実行できます。

npm run local

単体テストを実行するには、以下のコマンドを実行します。

npm test

または、単一のファイルに対してテストを実行するには、以下のコマンドを使用します。

node --test --import tsx <FILE_PATH>