MIRO Whiteboard Connector MCP Server 使用说明

项目简介

MIRO Whiteboard Connector MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它充当 LLM（如 Claude）与 Miro 白板之间的桥梁。通过此服务器，LLM 可以理解和操作 Miro 白板上的内容，例如读取白板信息、创建便利贴、图形等，从而实现更智能的白板互动体验。

主要功能点

访问 Miro 白板资源：允许 LLM 获取 Miro 白板的内容，例如白板上的所有元素（便利贴、图形等）。
操作 Miro 白板元素：支持 LLM 在 Miro 白板上创建和编辑元素，例如创建便利贴、形状等。
批量操作：支持一次性创建多个 Miro 白板元素，提高操作效率。
Prompt 模板支持：提供 Prompt 模板，帮助用户通过自然语言指令与 Miro 白板进行交互。

安装步骤

安装 Node.js 和 npm：确保你的电脑上已安装 Node.js 和 npm (Node 包管理器)。
使用 mcp-get 安装：打开终端或命令提示符，运行以下命令安装 MIRO Whiteboard Connector MCP Server：
```
npx @michaellatman/mcp-get@latest install @llmindset/mcp-miro
```
如果遇到权限问题，请尝试使用管理员权限运行命令提示符。
配置 Miro OAuth 令牌：
- 你需要一个 Miro OAuth 令牌才能连接到 Miro API。
- 可以将令牌设置为环境变量 'MIRO_OAUTH_TOKEN'。
- 或者在配置服务器时，通过 '--token' 参数传递令牌。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）一起使用，你需要配置客户端的服务器配置文件。以下是 Claude Desktop 的配置示例，你需要根据你的 MCP 客户端进行相应配置。

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", // Node.js 或 npx 的路径，根据你的环境配置
      "arguments": [
        "/path/to/mcp-miro/build/index.js", // mcp-miro 服务器入口文件路径，根据实际安装路径配置
        "--token","YOUR_MIRO_OAUTH_TOKEN" // 你的 Miro OAuth 令牌，替换为你的实际令牌
      ]
    }
  }
}

参数注释:

'server name': 服务器的名称，在客户端中用于标识和管理不同的 MCP 服务器连接。
'command': 启动 MCP 服务器的命令，通常是 Node.js 或 npx 的可执行文件路径。
'arguments': 传递给 'command' 的参数列表，用于配置和启动 MCP 服务器。
- '/path/to/mcp-miro/build/index.js': MCP 服务器主程序入口文件的绝对路径。你需要将其替换为你实际安装 'mcp-miro' 包后的 'index.js' 文件的路径。
- '--token YOUR_MIRO_OAUTH_TOKEN': 用于 Miro API 身份验证的 OAuth 令牌。请将 'YOUR_MIRO_OAUTH_TOKEN' 替换为你从 Miro 开发者平台获取的 OAuth 令牌。

注意: 请将 '/path/to/node-or-npx' 和 '/path/to/mcp-miro/build/index.js' 替换为你的实际安装路径。你可以通过在终端中输入 'which node' 或 'which npx' (MacOS/Linux) 或 'where node' 或 'where npx' (Windows) 找到 Node.js 或 npx 的路径。 'mcp-miro' 的安装路径通常在你的用户目录下的 '.mcp-servers' 目录中。

基本使用方法

启动 MCP 客户端：配置完成后，启动你的 MCP 客户端 (例如 Claude Desktop)。
连接到 MIRO Whiteboard Connector：客户端应该能够检测到并连接到你配置的 'mcp-miro' 服务器。
通过 LLM 指令操作 Miro 白板：现在你可以通过 LLM 的自然语言指令来访问和操作 Miro 白板了。例如，你可以让 Claude 列出你的 Miro 白板，或者在指定的白板上创建一个便利贴。

示例指令:

"列出我的 Miro 白板"
"在白板 [白板ID] 上创建一个内容为 '会议纪要' 的黄色便利贴"
"获取白板 [白板ID] 的内容"

具体指令取决于你的 LLM 客户端和 Prompt 的设计。请参考客户端的文档和 Prompt 模板来了解更多使用方法。

关键词