Miro MCP Server

🚀 Miro MCP 服務器

Miro MCP 服務器 是 模型上下文協議 (MCP) 的一個實現，與 Miro 的 REST API 集成。它讓 AI 系統能直接在 Miro 看板上與用戶協作，通過操作看板上的部件來完成各種任務，為大型語言模型提供了使用 MCP 協議創建視覺圖表和進行即時協作的能力。

🚀 快速開始

Miro MCP 服務器是模型上下文協議 (MCP) 的實現，與 Miro 的 REST API 集成。它能讓 AI 系統在 Miro 看板上與用戶協作，還提供工具讓大型語言模型使用 MCP 協議創建視覺圖表並即時協作。

✨ 主要特性

• 看板協作：可自動化 Miro 看板上的協作。
• 數據分析：能分析當前看板的狀態，並從視覺佈局中提取有用信息。
• AI 動力工具：藉助大型語言模型協助結構化圖表創建、頭腦風暴和視覺任務規劃。

📦 安裝指南

你可以選擇下載預編譯的 JAR 文件，或者自行構建項目。

選項 1：使用預編譯 JAR

1. 從 發佈 頁面下載最新版本。
2. 將 .jar 文件放在你想要的位置。

選項 2：從源碼構建

git clone https://github.com/MaratMingazov/miro-mcp-server.git
cd miro-mcp-server
./gradlew build

生成的 .jar 文件將位於 build/libs/miro-mcp-server-1.0.jar。

📚 詳細文檔

連接 MCP 服務器

如果你使用的是 MacOS 或 Linux 上的 Claude Desktop 應用，配置文件位於：

~/Library/Application\ 支持/Claude/claude_desktop_config.json

在文件中添加以下配置：

{
  "mcpServers": {
    "miro-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/miro-mcp-server-1.0.jar",
        "--token=miroToken"
      ]
    }
  }
}

將 /path/to/miro-mcp-server-1.0.jar 替換為你實際的 .jar 文件路徑，並將 miroToken 替換為你的 Miro 個人訪問令牌。你可以按照 此指南 生成個人訪問令牌。

工具

部件

• getWidgets - 獲取看板上的部件
  • boardKey: 要獲取部件的 Miro 看板密鑰

備註

• createSticky - 在 Miro 看板上創建備註（貼紙）部件
  • boardKey: 要創建貼紙的 Miro 看板密鑰
  • stickyNoteText: 顯示在貼紙上的文本
  • x: 貼紙的 x 座標位置
  • y: 貼紙的 y 座標位置
  • width: 貼紙的寬度（可選）
  • height: 貼紙的高度（可選）

看板

• createBoard - 創建新的 Miro 看板
  • name: 新看板的名稱
  • description: 新看板的描述（可選）

💻 使用示例

基礎用法

如何使用 LLM 創建一個簡單的圖表：

1. 使用 createBoard 創建一個新的看板。
2. 使用 createSticky 在新看板上添加備註部件。
3. 調整部件的位置和其他屬性以完成圖表。

通過這些工具，你可以輕鬆地在 Miro 看板上進行協作和創建複雜的內容。