关于 mcp-miro MCP Server
mcp-miro 是一个连接 MIRO 白板应用的 MCP 服务,支持对白板进行操作、创建便签并执行批量操作。README 建议可通过图片转写便签内容的方式辅助创建白板内容。
主要功能
- 01白板内容读取与操作
- 02创建便签与图形
- 03读取白板、Frame 及内容
- 04批量创建内容
- 05通过 OAuth 密钥或 --token 参数认证
适用场景
- 01将实体便签内容转换为 MIRO 白板便签
- 02通过 Claude 批量生成白板内容
- 03读取 MIRO 白板内容供 Claude 分析
MCP 相关
该项目是一个 MCP 服务,向 MCP 客户端(如 Claude Desktop)暴露 MIRO 白板的资源、工具与提示词。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
mcp-miro MCP 服务
一个用于连接 MIRO 白板应用的模型上下文协议服务。
- 支持操作白板、创建便利贴、批量操作等。
- 将 OAuth 密钥作为环境变量传入,或使用“--token”参数。
- 拍摄便利贴的照片并让 Claude 创建对应的 MIRO 内容,效果非常好。
安装
通过 Smithery 安装
如需通过 Smithery 自动为 Claude Desktop 安装 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 服务通过 stdio 通信,调试可能颇具挑战。我们建议使用 MCP Inspector,它可通过软件包脚本运行:
npm run inspector
Inspector 会提供一个 URL,供你在浏览器中访问调试工具。
在开发环境中,建议添加 https://github.com/miroapp/api-clients/blob/041de24ebf7955432b447d887ede066ad4c7e2c7/packages/generator/spec.json 以供参考。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。