Console MCP Server

🚀 Mia-Platform控制檯MCP服務器

Mia-Platform控制檯MCP服務器是一款模型上下文協議（MCP）服務器，它能與Mia-Platform控制檯API實現無縫集成，助力開發者和相關工具實現高級自動化與交互功能。

🚀 快速開始

先決條件

1. 若要在容器中運行服務器，您需安裝 Docker。
2. 安裝完成後，請確保 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>

📄 許可證

本項目遵循相關開源許可證，具體請查看 LICENSE 文件。