JinDaGe - console-mcp-server MCP Details

article

README

🚀 Mia-Platform控制台MCP服务器

Mia-Platform控制台MCP服务器是一个模型上下文协议（MCP）服务器，它能与Mia-Platform控制台API实现无缝集成，助力开发者和开发工具实现高级自动化和交互功能。

🚀 快速开始

先决条件

若要在容器中运行服务器，您需要安装 Docker。
安装完成后，请确保Docker处于运行状态。
您需要创建Mia-Platform服务账户。目前唯一支持的身份验证方法是客户端机密基本。

📦 安装指南

VS Code

手动安装时，您可以按Ctrl + Shift + P并输入偏好设置：打开用户设置（JSON），在打开的用户设置（JSON）文件中添加以下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>

console-mcp-server