Miro MCP Server

🚀 Miro MCP Server

AIを使ってMiroのホワイトボードを制御します。高速かつシンプルな操作を実現するためにGo言語で構築されています。

コミュニティプロジェクト — Miroとは公式には関係ありません。下記の公式版との比較をご覧ください。

77のツール | シングルバイナリ | 全プラットフォーム対応 | 主要なAIツール全て対応

🚀 クイックスタート

1. インストール

Homebrew (macOS/Linux):

brew tap olgasafonova/tap && brew install miro-mcp-server

ワンライナ (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/olgasafonova/miro-mcp-server/main/install.sh | sh

Docker:

docker pull ghcr.io/olgasafonova/miro-mcp-server:latest

手動ダウンロード: 全プラットフォームの手順はSETUP.mdを参照してください。

2. Miroトークンの取得

1. miro.com/app/settings/user-profile/appsにアクセスします。
2. boards:read と boards:write のパーミッションを持つアプリを作成します。
3. チームにインストールし、トークンをコピーします。

3. AIツールの設定

Claude Code:

claude mcp add miro -e MIRO_ACCESS_TOKEN=your-token -- miro-mcp-server

Claude Desktop / Cursor / VS Code: 設定方法はSETUP.mdを参照してください。

✨ 主な機能

できること一覧

音声操作の例

• "黄色の付箋に 'Review PRs' と書いて追加"
• "フローチャートを作成: 開始 → 決定 → 終了"
• "私が持っているボードはどれ？"
• "Designボードを jane@example.com と共有"
• "「Project Ideas」をルートとするマインドマップを作成"

77のツール一覧

ダイアグラム生成

Mermaid構文からフローチャートやシーケンス図を作成できます。

フローチャート:

flowchart TB
    A[Start] --> B{Decision}
    B -->|Yes| C[Success]
    B -->|No| D[Retry]
    D --> B

シーケンス図:

sequenceDiagram
    Alice->>Bob: Hello Bob!
    Bob-->>Alice: Hi Alice!

サポートされるもの: flowchart/graph, sequenceDiagram, 方向 (TB/LR/BT/RL), 形状 ([] 矩形, {} ダイヤモンド, (()) 円), ラベル付きのエッジ

📦 インストール

インストール方法はクイックスタートの「1. インストール」を参照してください。

💻 使用例

基本的な使用法

各種操作のコマンド例はクイックスタートや各機能の説明を参照してください。

高度な使用法

高度なシナリオについては、各種設定や操作の詳細をSETUP.mdなどのドキュメントを参照してください。

📚 ドキュメント

🔧 技術詳細

このサーバーの利点

公式版との比較

Miroは公式のMCPサーバー（ベータ版）をリリースしています。以下は比較です。

公式サーバーを使う場合: MiroがサポートするツールとAIベースのダイアグラム生成が必要な場合。

このサーバーを使う場合: 完全なAPIサーフェイス、一括操作、マインドマップ、タグ、または軽量なバイナリが必要な場合。

両方を共存させることもできます — 設定で異なるMCPサーバー名を使用してください。

パフォーマンス

• キャッシュ: 2分のTTLでAPI呼び出しを削減
• レート制限: Miroのレート制限ヘッダーに適応
• サーキットブレーカー: 障害のあるエンドポイントを隔離
• 並列一括操作: アイテムを並列に作成
• トークン検証: 起動時にエラーがあれば即座に失敗
• 一時的なエラーリトライ: 502/503/504エラーをバックオフで自動リトライ

最適化のヒントとベンチマークについてはPERFORMANCE.mdを参照してください。

HTTPモードのエンドポイント

-http :8080 で実行する場合:

ヘルスチェックのレスポンス:

{
  "status": "healthy",
  "server": "miro-mcp-server",
  "version": "1.9.0",
  "uptime": "2h30m",
  "components": {
    "config": {"status": "healthy"},
    "miro_api": {"status": "healthy", "latency": "145ms"}
  }
}

🔧 開発

# ビルド
make build

# テストの実行
make test

# カバレッジ付きでテストを実行
make test-cover

# リント
make lint

# 全プラットフォーム向けにビルド
make build-all

# すべてのターゲットを表示
make help

🐳 Dockerデプロイ

クイックスタート:

# docker-composeを使用する場合
export MIRO_ACCESS_TOKEN=your-token
docker-compose up -d

# または手動でビルドして実行
docker build -t miro-mcp-server .
docker run -e MIRO_ACCESS_TOKEN=xxx -p 8080:8080 miro-mcp-server

docker-compose.ymlの機能:

• ヘルスチェックが設定されている
• リソース制限のテンプレート
• 環境変数のパススルー

🐞 MCPインスペクターでのデバッグ

MCPインスペクターを使ってサーバーを対話的にテストし、デバッグできます。

# インストールして実行 (設定不要)
npx @modelcontextprotocol/inspector miro-mcp-server

# 環境変数を指定する場合
MIRO_ACCESS_TOKEN=your-token npx @modelcontextprotocol/inspector miro-mcp-server

http://localhost:6274 を開くと、以下ができます。

• 77のツールとそのスキーマを閲覧
• ツール呼び出しを対話的にテスト
• 生のJSON-RPCメッセージを表示
• パラメーター検証をデバッグ

詳細なデバッグオプションはSETUP.mdを参照してください。

📱 サポートされるプラットフォーム

🤖 サポートされるAIツール

設定ガイドはSETUP.mdを参照してください。

👤 アカウント互換性

🌟 このプロジェクトが気に入ったら

このサーバーがあなたの時間を節約した場合、GitHubで⭐を付けることを検討してください。他の人がこのプロジェクトを発見するのに役立ちます。

🚀 他のMCPサーバー

他のMCPサーバーもチェックしてみてください。

サーバー	説明	スター数
gleif-mcp-server	GLEIF LEIデータベースにアクセスします。企業の識別情報を検索し、法的エンティティを検証します。
mediawiki-mcp-server	AIを任意のMediaWikiウィキに接続します。ウィキの内容を検索、閲覧、編集します。
productplan-mcp-server	ProductPlanのロードマップと対話します。OKR、アイデア、ローンチをクエリします。

📄 ライセンス

MIT

Miro と MCP コミュニティ向けに構築されています。
_{MiroはMiro Inc.の商標です。このプロジェクトはMiroと関係なく、また承認もされていません。}