mcp-miro 是一个基于 Model Context Protocol（MCP）的服务器，旨在连接 Miro 白板应用程序。它允许 AI 助手（如 Claude）通过 MCP 协议与 Miro 进行交互，实现对白板的操控。
主要能力包括：
- 读取白板内容（包括框架、便签等）
- 创建便签、形状等元素
- 执行批量操作
- 获取白板内容
- 支持通过 OAuth 密钥进行认证，密钥可通过环境变量或 --token 参数传递
使用方式：
- 安装依赖并构建服务器。
- 在 Claude Desktop 的配置文件中添加服务器配置（MacOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json；Windows 路径：%APPDATA%/Claude/claude_desktop_config.json）。
- 由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性，推荐使用 MCP Inspector 进行调试，该工具可通过包脚本获得，并提供浏览器访问的 URL。
- 在开发环境中，建议参考 https://github.com/miroapp/api-clients/blob/041de24ebf7955432b447d887ede066ad4c7e2c7/packages/generator/spec.json。
该项目还支持通过 Smithery 自动安装 MIRO Whiteboard Connector 到 Claude Desktop。也可以使用 mcp-get 安装。注意：如果使用旧版 Windows PowerShell，可能需要先运行 Set-ExecutionPolicy Bypass -Scope Process。
适用场景：
- 需要将 Miro 白板与 AI 助手集成，通过自然语言指令进行白板操作。
- 批量创建和读取 Miro 白板元素。
- 利用 AI 进行白板内容的自动化处理，例如拍照便签后让 Claude 创建对应的 Miro 元素。
限制：
- 需要有效的 OAuth 密钥。
- 依赖于 MCP 协议和兼容的 AI 助手（如 Claude Desktop）。
- 部分安装步骤可能因操作系统而异。
