Miro MCP Server

Miro MCP 服务

概述

Miro MCP 服务是 Model Context Protocol (MCP) 的一种实现，可与 Miro 的 REST API 集成。它支持 AI 系统通过操作白板组件，直接与用户协作处理 Miro 白板。此服务提供 AI 模型可用于构建可视化图表和开展实时协作的工具。

使用场景

• 白板协作：自动化 Miro 白板上的协作。
• 数据分析：分析 Miro 白板的当前状态，并从可视化布局中提取有用信息。
• AI 驱动的工具：使用大模型，通过 MCP 协议协助创建结构化图表、头脑风暴和可视化任务规划。

安装

你可以从 Releases 页面下载预编译的 JAR 文件，也可以自行构建项目。

选项 0：使用公开的 Docker 镜像

将以下配置添加到你的文件中：

{
  "mcpServers": {
    "miro-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "MIRO_TOKEN=your_miro_token_here",
        "maratmingazovr/miro-mcp-server:1.0"
      ]
    }
  }
}

选项 1：使用预构建的 JAR

1. 从 Releases 页面下载最新版本。
2. 将 .jar 文件放在所需位置。

选项 2：从源代码构建

git clone https://github.com/MaratMingazov/miro-mcp-server.git
cd miro-mcp-server
./gradlew build

生成的 .jar 文件位于 build/libs/miro-mcp-server-1.0.jar。

连接 MCP 服务

如果你在 MacOS 或 Linux 上使用 Claude Desktop 应用，可以在以下位置找到配置文件：

~/Library/Application\ Support/Claude/claude_desktop_config.json

将以下配置添加到你的文件中：

{
  "mcpServers": {
    "miro-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/miro-mcp-server-1.0.jar",
        "--MIRO_TOKEN=miroToken"
      ]
    }
  }
}

将 /path/to/miro-mcp-server-1.0.jar 替换为 .jar 文件的实际路径，并将 miroToken 替换为你的 Miro 个人访问令牌。

你可以按照本指南生成个人访问令牌。

工具

组件

• getWidgets - 获取 Miro 白板上的组件
  • boardKey：要获取组件的 Miro 白板密钥

便签

• createSticky - 在 Miro 白板上创建便签组件（贴纸）

  • boardKey：要获取组件的 Miro 白板密钥
  • stickyNoteText：贴纸上显示的文本
  • x：贴纸的 x 坐标
  • y：贴纸的 y 坐标
  • width：贴纸宽度
  • fillColor：贴纸填充颜色

连接线

• createConnector - 在指定的两个组件之间创建连接线组件

  • boardKey：要获取组件的 Miro 白板密钥
  • firstWidgetId：连接线的第一个组件 ID
  • secondWidgetId：连接线的第二个组件 ID
  • connectorText：连接线上显示的文本

使用示例

以下是一个示例提示词，可用于指示 Claude 或其他大模型 Agent 与 Miro 白板交互：

I want you to create a simple diagram on a Miro board.
Please follow the next steps:
1 - Create a sticky note with some text.
2 - Create the second sticky with a different text.
3 - Now create a line between the two sticky notes using the id's of previously created stickers.

---

欢迎在 Issues 页面贡献内容或报告问题。