Miro MCP Server

Miro MCP Server

Miro API および単一のボードと連携するための、実験的な Model Control Protocol（MCP）サーバーです。

概要

このプロジェクトは、Miro API エンドポイントを AI エージェントが使用できるツールとして公開する FastMCP サーバーを提供します。Miro の OpenAPI 仕様からツール定義を自動生成するため、AI エージェントはプログラムで Miro ボードを操作できます。

機能

• Miro ボードの主要なアイテムタイプすべてに対応しています。
  • 付箋
  • 図形
  • テキスト
  • 画像
  • カード
  • アプリカード
  • ドキュメント
  • 埋め込み
  • コネクター

前提条件

• Node.js
• API アクセスが可能な Miro アカウント
• Miro API トークン
• Miro ボード ID

Docker を使用しないインストール

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-server-miro.git
   cd mcp-server-miro
   

2. 依存関係をインストールします。

   npm install
   

3. ルートディレクトリに、以下の変数を含む .env ファイルを作成します。

   MIRO_API_TOKEN=your_miro_api_token
   MIRO_BOARD_ID=your_miro_board_id
   
   # Optional, port
   PORT=3000
   

使い方

1. サーバーを起動します。

   npm run dev
   

   または

   npm run build
   npm start
   

2. サーバーは http://localhost:8899/sse で起動します。

3. AI エージェントは、MCP プロトコルを介して公開された Miro API ツールを使用できるようになります。

Docker を使用する場合

# The exact command depends on your Docker version
docker compose up -d
docker-compose up -d

# Server should be up in default port or the one you chose

API ツール

サーバーは、以下の Miro API エンドポイントをツールとして公開します。

ボード操作：

• get_specific_board：現在のボードの情報を取得します。
• update_board：現在のボードを更新します。

汎用アイテム操作：

• get_items：ボード上のアイテム一覧を取得します（フィルタリングとページネーションに対応）。
• update_item_position_or_parent：特定のアイテムの位置または親を更新します。
• delete_item：特定のアイテムを削除します（付箋、テキスト、図形など、さまざまなタイプに対応）。

付箋操作：

• create_sticky_note_item：付箋を追加します。
• get_sticky_note_item：特定の付箋を取得します。
• update_sticky_note_item：特定の付箋を更新します。

テキスト操作：

• create_text_item：テキストアイテムを追加します。
• get_text_item：特定のテキストアイテムを取得します。
• update_text_item：特定のテキストアイテムを更新します。

図形操作：

• create_shape_item：図形アイテムを追加します。
• get_shape_item：特定の図形アイテムを取得します。
• update_shape_item：特定の図形アイテムを更新します。

カード操作：

• create_card_item：カードアイテムを追加します。
• get_card_item：特定のカードアイテムを取得します。
• update_card_item：特定のカードアイテムを更新します。

コネクター操作：

• create_connector：アイテム間にコネクターを追加します。
• get_connectors：コネクター一覧を取得します。
• get_connector：特定のコネクターを取得します。
• update_connector：特定のコネクターを更新します。
• delete_connector：特定のコネクターを削除します。

ドキュメント操作：

• create_document_item_using_url：URL からドキュメントアイテムを追加します。
• update_document_item_using_url：URL から追加したドキュメントアイテムを更新します。 （注：特定のドキュメントの取得には get_items を使用します）

埋め込み操作：

• create_embed_item：URL から埋め込みアイテムを追加します。
• update_embed_item：埋め込みアイテムを更新します。 （注：特定の埋め込みの取得には get_items を使用します）

画像操作：

• create_image_item_using_url：URL から画像アイテムを追加します。
• update_image_item_using_url：URL から追加した画像アイテムを更新します。 （注：特定の画像の取得には get_items を使用します）

アプリカード操作：

• create_app_card_item：アプリカードアイテムを追加します。
• update_app_card_item：アプリカードアイテムを更新します。 （注：特定のアプリカードの取得には get_items を使用します）

ライセンス

MIT