项目简介

mcp-miro 是一个 Model Context Protocol (MCP) 服务器，它充当 Claude 等 LLM 客户端与 Miro 白板应用之间的桥梁。通过 mcp-miro 服务器，LLM 可以安全、可扩展地访问和操作 Miro 白板，实现更智能的应用集成。

主要功能点

资源 (Resources):
- 获取 Miro 白板列表
- 读取白板内容 (JSON格式)
工具 (Tools):
- 创建便利贴 (Sticky Note)
- 创建图形 (Shape)
- 读取白板、画框 (Frame)、内容
- 批量创建元素
Prompt 模板 (Prompts):
- 提供与白板坐标等相关的指令模板，方便用户定制与 Miro 白板的交互方式

选择安装方式: 你可以通过 Smithery 或 mcp-get 两种方式安装 mcp-miro 服务器。

使用 Smithery 安装 (推荐 Claude Desktop 用户): 打开终端并运行以下命令：

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

使用 mcp-get 安装: 打开终端并运行以下命令：

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

获取 Miro OAuth 令牌 (token): 你需要一个 Miro OAuth 令牌才能连接到 Miro API。请参考 Miro 开发者文档获取你的令牌。

为了让 MCP 客户端 (例如 Claude Desktop) 连接到 mcp-miro 服务器，你需要配置客户端的服务器列表。以 Claude Desktop 为例，你需要编辑配置文件 'claude_desktop_config.json'。

找到配置文件:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
编辑配置文件: 在 'mcpServers' 字段下添加 'mcp-miro' 服务器的配置。你需要提供服务器的启动命令 'command' 和参数 'arguments'。
```
{
  "mcpServers": {
    "mcp-miro": {
      "command": "/path/to/node-or-npx",
      "arguments": [
        "/path/to/mcp-miro/build/index.js",
        "--token",
        "YOUR_MIRO_OAUTH_TOKEN"
      ]
    }
  }
}
```
配置参数说明:
- 'command': Node.js 或 npx 的可执行文件路径。通常如果你安装了 Node.js，可以直接使用 'node' 或 'npx'。
- 'arguments': 启动 'mcp-miro' 服务器的参数列表。
  - 第一个参数: 'index.js' 文件的路径。请替换为 'mcp-miro' 项目 'build' 目录下 'index.js' 文件的绝对路径。
  - '--token': 必须参数。用于 Miro API 鉴权的 OAuth 令牌。请将 'YOUR_MIRO_OAUTH_TOKEN' 替换为你自己的 Miro OAuth 令牌。
注意: 请根据你的实际 Node.js 安装路径和 'mcp-miro' 项目的安装位置，修改 'command' 和 'arguments' 中的路径。

启动 MCP 客户端: 启动配置了 mcp-miro 服务器的 MCP 客户端 (例如 Claude Desktop)。
连接 Miro 白板: 客户端应该能够通过 mcp-miro 服务器连接到你的 Miro 账户。
使用 LLM 与 Miro 交互: 现在你可以指示 LLM 使用 mcp-miro 提供的资源和工具来访问和操作你的 Miro 白板了。例如，你可以让 Claude 列出你的 Miro 白板，或者在指定的白板上创建一个新的便利贴。