JinDaGe - mcp-miro MCP Details

article

README

🚀 MCP 与 Miro 白板服务器

这是一个用于连接 MIRO 白板应用程序的 Model Context Protocol（MCP）服务器。它允许进行看板操作、贴纸创建、批量操作等，还可通过环境变量或 --token 参数传递 OAuth 密钥。此外，使用 Claude 拍摄贴纸照片并生成 MIRO 相当的实现效果非常出色。

🚀 快速开始

本服务器可助力您轻松连接 MIRO 白板应用程序，实现多样化的看板操作。

✨ 主要特性

丰富操作功能：允许进行看板操作、贴纸创建、批量操作等。
灵活密钥传递：可通过环境变量或 --token 参数传递 OAuth 密钥。
出色效果呈现：使用 Claude 拍摄贴纸照片并生成 MIRO 相当的实现效果非常出色。

MIRO/Claude Desktop 截图

资源

获取看板内容

工具

创建贴纸、形状
读取看板、框架、内容
批量创建

提示语

指令中的板坐标等信息

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 MIRO 白板连接器：

npx -y @smithery/cli install @llmindset/mcp-miro --client claude

使用 mcp-get 安装

您可以通过 mcp-get 安装此包：

npx @michaellatman/mcp-get@latest install @llmindset/mcp-miro

⚠️ 重要提示

如果您使用的是旧版本 Windows PowerShell，请在运行以上命令之前执行 Set-ExecutionPolicy Bypass -Scope Process。

💻 使用示例

开发环境搭建

安装依赖

npm install

构建服务器

npm run build

开发时自动重建

npm run watch

安装说明

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-miro": {
      "command": "/path/to/node-or-npx",
      "arguments": [
        "/path/to/mcp-miro/build/index.js",
        "--token","MIRO-OAUTH-KEY"
      ]
    }
  }
}

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP 检查器，它作为包脚本提供：

npm run inspector

检查器会提供一个 URL，供您在浏览器中访问调试工具。

💡 使用建议

在开发环境中建议参考：https://github.com/miroapp/api-clients/blob/041de24ebf7955432b447d887ede066ad4c7e2c7/packages/generator/spec.json

mcp-miro