Miro MCP 服务器

概述

Miro MCP 服务器 是 模型上下文协议 (MCP) 的一个实现，与 Miro 的 REST API 集成。它使 AI 系统能够直接在 Miro 看板上与用户协作，通过交互看板上的部件进行操作。此服务器提供工具，使得大型语言模型可以使用 MCP 协议创建视觉图表并进行实时协作。

使用场景

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

安装

你可以下载预编译的 JAR 文件，或者自行构建项目。

选项 1：使用预编译 JAR

1. 从 发布 页面下载最新版本。
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\ 支持/Claude/claude_desktop_config.json

在文件中添加以下配置：

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

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

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

工具

部件

• getWidgets - 获取看板上的部件
  • boardKey: 要获取部件的 Miro 看板密钥

备注

• createSticky - 在 Miro 看板上创建备注（贴纸）部件
  • boardKey: 要创建贴纸的 Miro 看板密钥
  • stickyNoteText: 显示在贴纸上的文本
  • x: 贴纸的 x 坐标位置
  • y: 贴纸的 y 坐标位置
  • width: 贴纸的宽度（可选）
  • height: 贴纸的高度（可选）

看板

• createBoard - 创建新的 Miro 看板
  • name: 新看板的名称
  • description: 新看板的描述（可选）

示例用法

如何使用 LLM 创建一个简单的图表：

1. 使用 createBoard 创建一个新的看板。
2. 使用 createSticky 在新看板上添加备注部件。
3. 调整部件的位置和其他属性以完成图表。

通过这些工具，你可以轻松地在 Miro 看板上进行协作和创建复杂的内容。