🚀 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 文件。