MCP Miro Server

MCP Miro サーバー

Miro プラットフォームと連携する Model Context Protocol（MCP）サーバーです。AI アシスタント（Claude など）が、標準化されたインターフェースを通じて Miro のボードにアクセスし、そのコンテンツを管理できます。

---

必要条件

• Node.js v16 以降がインストールされていること
• API トークンを取得できる Miro アカウント

Miro アクセストークンの生成

1. Miro Developer Portal にアクセスします
2. 新しいアプリを作成するか、既存のアプリを使用します
3. 以下の権限を選択してトークンを作成してください
4. Install app and get OAuth token を選択して OAuth トークンを生成します

権限	必須
boards:read	✅
boards:write	✅
identity:read	✅
identity:write	✅
team:read	✅
team:write	✅
microphone:listen	❌
screen:record	❌
webcam:record	❌
auditlogs:read	❌
sessions:delete	❌

Claude Desktop との接続

1. Claude Desktop をインストールします

2. 設定ファイルを開くか、作成します：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 以下のサーバー設定を追加します：

{
   "mcpServers":{
      "miro":{
         "command":"npx",
         "args":[
            "-y",
            "@k-jarzyna/mcp-miro"
         ],
         "env":{
            "MIRO_ACCESS_TOKEN":"your_miro_access_token"
         }
      }
   }
}

4. Claude Desktop を再起動します

---

利用可能なツールとリソース

ツール

Miro SDK 関数	MCP ツール	利用可能
ボード一覧を取得	list-boards	✅
ボードを作成	create-board	✅
ボードを更新	update-board	✅
ボードを削除	delete-board	✅
ボードをコピー	copy-board	✅
特定のボードを取得	get-specific-board	✅
ボード上のアイテムを取得	get-items-on-board	✅
特定のアイテムを取得	get-specific-item	✅
アイテムの位置を更新	update-item-position	✅
アイテムを削除	delete-item	✅
アプリカードアイテムを作成	create-app-card-item	✅
アプリカードアイテムを取得	get-app-card-item	✅
アプリカードアイテムを更新	update-app-card-item	✅
アプリカードアイテムを削除	delete-app-card-item	✅
カードアイテムを作成	create-card-item	✅
カードアイテムを取得	get-card-item	✅
カードアイテムを更新	update-card-item	✅
カードアイテムを削除	delete-card-item	✅
コネクターを作成	create-connector	✅
コネクター一覧を取得	get-connectors	✅
特定のコネクターを取得	get-specific-connector	✅
コネクターを更新	update-connector	✅
コネクターを削除	delete-connector	✅
付箋アイテムを作成	create-sticky-note-item	✅
付箋アイテムを取得	get-sticky-note-item	✅
付箋アイテムを更新	update-sticky-note-item	✅
付箋アイテムを削除	delete-sticky-note-item	✅
フレームを作成	create-frame	✅
フレームアイテムを取得	get-frame-item	✅
フレームアイテムを更新	update-frame-item	✅
フレームアイテムを削除	delete-frame-item	✅
ドキュメントアイテムを作成	create-document-item	✅
ドキュメントアイテムを取得	get-document-item	✅
ドキュメントアイテムを更新	update-document-item	✅
ドキュメントアイテムを削除	delete-document-item	✅
テキストアイテムを作成	create-text-item	✅
テキストアイテムを取得	get-text-item	✅
テキストアイテムを更新	update-text-item	✅
テキストアイテムを削除	delete-text-item	✅
アイテムを一括作成	create-items-in-bulk	✅
URL を使用して画像アイテムを作成	create-image-item-using-url	✅
ファイルを使用して画像アイテムを作成	create-image-item-using-file	✅
画像アイテムを取得	get-image-item	✅
画像アイテムを更新	update-image-item	✅
ファイルを使用して画像アイテムを更新	update-image-item-using-file	✅
画像アイテムを削除	delete-image-item	✅
図形アイテムを作成	create-shape-item	✅
図形アイテムを取得	get-shape-item	✅
図形アイテムを更新	update-shape-item	✅
図形アイテムを削除	delete-shape-item	✅
埋め込みアイテムを作成	create-embed-item	✅
埋め込みアイテムを取得	get-embed-item	✅
埋め込みアイテムを更新	update-embed-item	✅
埋め込みアイテムを削除	delete-embed-item	✅
タグを作成	create-tag	✅
タグを取得	get-tag	✅
すべてのタグを取得	get-all-tags	✅
タグを更新	update-tag	✅
タグを削除	delete-tag	✅
タグを添付	attach-tag	✅
タグを取り外す	detach-tag	✅
アイテムのタグを取得	get-item-tags	✅
すべてのボードメンバーを取得	get-all-board-members	✅
特定のボードメンバーを取得	get-specific-board-member	✅
ボードメンバーを削除	remove-board-member	✅
ボードを共有	share-board	✅
ボードメンバーを更新	update-board-member	✅
グループを作成	create-group	✅
すべてのグループを取得	get-all-groups	✅
グループを取得	get-group	✅
グループのアイテムを取得	get-group-items	✅
グループを更新	update-group	✅
アイテムのグループ化を解除	ungroup-items	✅
グループを削除	delete-group	✅
ファイルを使用してアイテムを一括作成	create-items-in-bulk-using-file	✅
マインドマップノードを作成	create-mindmap-node	✅
マインドマップノードを取得	get-mindmap-node	✅
マインドマップノード一覧を取得	get-mindmap-nodes	✅
マインドマップノードを削除	delete-mindmap-node	✅
プロジェクトメンバーを追加	add-project-member	✅
ボードのエクスポートジョブを作成	create-board-export-job	✅
すべてのケースを取得	get-all-cases	✅
すべてのリーガルホールドを取得	get-all-legal-holds	✅
監査ログを取得	get-audit-logs	✅
ボードの分類を取得	get-board-classification	✅
ボードのコンテンツログを取得	get-board-content-logs	✅
ボードのエクスポートジョブの結果を取得	get-board-export-job-results	✅
ボードのエクスポートジョブのステータスを取得	get-board-export-job-status	✅
ケースを取得	get-case	✅
リーガルホールドを取得	get-legal-hold	✅
リーガルホールドのコンテンツアイテムを取得	get-legal-hold-content-items	✅
組織情報を取得	get-organization-info	✅
組織メンバーを取得	get-organization-member	✅
組織メンバー一覧を取得	get-organization-members	✅
プロジェクトメンバーを取得	get-project-member	✅
プロジェクトメンバーを削除	remove-project-member	✅
ボードの分類を更新	update-board-classification	✅

---

ローカル開発

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

npm install

2. テンプレートを基に .env ファイルを作成します。

cp .env.template .env

3. .env ファイルを編集し、Miro アクセストークンを追加します。

4. サーバーをビルドします。

npm run build

サーバーの実行

サーバーを実行するには、次のとおりです。

node build/index.js

---

ライセンス

Apache License 2.0

このプロジェクトは Apache License, Version 2.0 の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。