Miro MCP Server

Miro MCP サーバー

概要

Miro MCP サーバーは、Miro REST APIと連携するModel Context Protocol（MCP）の実装です。ボード上のウィジェットを操作することで、AI システムが Miro ボード上でユーザーと直接共同作業できるようにします。このサーバーは、AI モデルが視覚的な図を作成し、リアルタイムで共同作業するために使用できるツールを提供します。

ユースケース

• ボードでの共同作業：Miro ボードでの共同作業を自動化します。
• データ分析：Miro ボードの現在の状態を分析し、視覚的なレイアウトから有用な情報を抽出します。
• AI を活用したツール：MCP プロトコルを使用して、大規模言語モデルによる構造化された図の作成、ブレインストーミング、視覚的なタスク計画を支援します。

インストール

Releasesページからコンパイル済みのJARファイルをダウンロードするか、プロジェクトをご自身でビルドできます。

オプション 0：公開 Docker イメージを使用する

ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "miro-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "MIRO_TOKEN=your_miro_token_here",
        "maratmingazovr/miro-mcp-server:1.0"
      ]
    }
  }
}

オプション 1：ビルド済み JAR を使用する

1. Releasesページから最新のリリースをダウンロードします。
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\ Support/Claude/claude_desktop_config.json

ファイルに以下の設定を追加します。

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

/path/to/miro-mcp-server-1.0.jarを実際の.jarファイルのパスに置き換え、miroTokenをMiroの個人アクセストークンに置き換えてください。

こちらのガイドに従って、個人アクセストークンを生成できます。

ツール

アイテム

• getWidgets - Miro ボード上のウィジェットを取得します
  • boardKey：ウィジェットを取得するMiroボードのキー

付箋

• createSticky - Miro ボードに付箋ウィジェット（ステッカー）を作成します

  • boardKey：ウィジェットを取得するMiroボードのキー
  • stickyNoteText：ステッカーに表示するテキスト
  • x：ステッカーのx座標
  • y：ステッカーのy座標
  • width：ステッカーの幅
  • fillColor：ステッカーの塗りつぶし色

コネクター

• createConnector - 指定した2つのウィジェット間にコネクター（線）ウィジェットを作成します

  • boardKey：ウィジェットを取得するMiroボードのキー
  • firstWidgetId：コネクターの最初のウィジェットID
  • secondWidgetId：コネクターの2番目のウィジェットID
  • connectorText：コネクターに表示するテキスト

使用例

以下は、Miro ボードを操作するようClaudeまたは別のLLMエージェントに指示するためのプロンプト例です。

I want you to create a simple diagram on a Miro board.
Please follow the next steps:
1 - Create a sticky note with some text.
2 - Create the second sticky with a different text.
3 - Now create a line between the two sticky notes using the id's of previously created stickers.

---

Issuesページで、ぜひ貢献や問題の報告をお寄せください。