Экспериментальный сервер Model Control Protocol (MCP) для взаимодействия с API Miro и единой платой.

Обзор

Этот проект предоставляет сервер FastMCP, который раскрывает конечные точки API Miro в качестве инструментов, которые могут использоваться агентами ИИ. Он автоматически генерирует определения инструментов из спецификации Miro OpenAPI, позволяя агентам ИИ программно манипулировать платами Miro.

Особенности

• Поддержка всех основных типов плат Miro:
• Липкие ноты
• Формы
• Текст
• Изображения
• Карты
• Приложения
• Документы
• Вставки
• Коннекторы

Предпосылки

• Node.js Учетная запись Miro с доступом к API
• Токен Miro API
• Идентификатор Миро.

##Установка без Docker

1. Клонировать хранилище:

2. Установить зависимости:

3. Создать файл .env в корневой директории со следующими переменными:

Использование

1.Запустите сервер:

или

2.Сервер начинается с http://localhost:8899/sse

3. Агенты ИИ теперь могут использовать открытые инструменты API Miro через протокол MCP

Использование Docker

Инструменты API

Сервер предоставляет следующие конечные точки API Miro в качестве инструментов:

Борские операции:

• [[Т2]]: Получает информацию о действующей коллегии.

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.