Miro API と単一のボードとやり取りするための実験的なモデル制御プロトコル(MCP)サーバー。

概要

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

##特徴

• すべての主要なミロ板項目タイプのためのサポート:
• スティッキーノート
• 形状
• テキスト
• 画像
• カード
• アプリカード
• 書類
• エンベッド
• コネクター

前提条件

• Node.jsの
• APIアクセスによるMiroアカウント
• Miro APIトークン
• ミロボードID

Dockerなしでインストール

1. リポジトリのクローン化:

2. 依存関係を取付けて下さい:

3. 次の変数でrootディレクトリにある[.env]ファイルを作成します。

使用法

1. サーバーを始めて下さい:

または

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

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

Docker で使う

API ツール

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

ボード操作:

• [get_specific_board: 現在のボードに関する情報を取得します.

Miro MCP Server

An experimental Model Control Protocol (MCP) server for interacting with the Miro API and a single board.

Overview

This project provides a FastMCP server that exposes Miro API endpoints as tools that can be used by AI agents. It automatically generates tool definitions from the Miro OpenAPI specification, allowing AI agents to manipulate Miro boards programmatically.

Features

• Support for all major Miro board item types:
  • Sticky notes
  • Shapes
  • Text
  • Images
  • Cards
  • App cards
  • Documents
  • Embeds
  • Connectors

Prerequisites

• Node.js
• A Miro account with API access
• A Miro API token
• A Miro board ID

Installation without Docker

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Create a .env file in the root directory with the following variables:

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

Usage

1. Start the server:

   npm run dev
   

   or

   npm run build
   npm start
   

2. The server will start at http://localhost:8899/sse

3. AI agents can now use the exposed Miro API tools through the MCP protocol

Using with 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 Tools

The server exposes the following Miro API endpoints as tools:

Board Operations:

• get_specific_board: Retrieves information about the current board.
• update_board: Updates the current board.

Generic Item Operations:

• get_items: Retrieves a list of items on the board (supports filtering and pagination).
• update_item_position_or_parent: Updates the position or parent of a specific item.
• delete_item: Deletes a specific item (covers various types like sticky notes, text, shapes, etc.).

Sticky Note Operations:

• create_sticky_note_item: Adds a sticky note.
• get_sticky_note_item: Retrieves a specific sticky note.
• update_sticky_note_item: Updates a specific sticky note.

Text Operations:

• create_text_item: Adds a text item.
• get_text_item: Retrieves a specific text item.
• update_text_item: Updates a specific text item.

Shape Operations:

• create_shape_item: Adds a shape item.
• get_shape_item: Retrieves a specific shape item.
• update_shape_item: Updates a specific shape item.

Card Operations:

• create_card_item: Adds a card item.
• get_card_item: Retrieves a specific card item.
• update_card_item: Updates a specific card item.

Connector Operations:

• create_connector: Adds a connector between items.
• get_connectors: Retrieves a list of connectors.
• get_connector: Retrieves a specific connector.
• update_connector: Updates a specific connector.