JinDaGe - miro-mcp-server MCP Details

article

README

🚀 Miro MCP 服务器

Miro MCP 服务器 是模型上下文协议 (MCP) 的一个实现，与 Miro 的 REST API 集成。它让 AI 系统能直接在 Miro 看板上与用户协作，通过操作看板上的部件来完成各种任务，为大型语言模型提供了使用 MCP 协议创建视觉图表和进行实时协作的能力。

🚀 快速开始

Miro MCP 服务器是模型上下文协议 (MCP) 的实现，与 Miro 的 REST API 集成。它能让 AI 系统在 Miro 看板上与用户协作，还提供工具让大型语言模型使用 MCP 协议创建视觉图表并实时协作。

✨ 主要特性

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

📦 安装指南

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

选项 1：使用预编译 JAR

从发布页面下载最新版本。
将 .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 创建一个简单的图表：

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

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

miro-mcp-server