Miro MCP Server
Overview
基本能力
产品定位
Miro MCP Server 是一个实验性的模型控制协议（MCP）服务器，用于与 Miro API 和单个看板进行交互。
核心功能
- 支持所有主要的 Miro 看板项目类型：
- 便签
- 形状
- 文本
- 图像
- 卡片
- 应用卡片
- 文档
- 嵌入
- 连接器
适用场景
- AI 代理通过 MCP 协议使用暴露的 Miro API 工具
- 编程方式操作 Miro 看板
工具列表
Board Operations:
- get_specific_board: 检索当前看板的信息。
- update_board: 更新当前看板。
Generic Item Operations:
- get_items: 检索看板上的项目列表（支持过滤和分页）。
- update_item_position_or_parent: 更新特定项目的位置或父级。
- delete_item: 删除特定项目（涵盖便签、文本、形状等各种类型）。
Sticky Note Operations:
- create_sticky_note_item: 添加便签。
- get_sticky_note_item: 检索特定便签。
- update_sticky_note_item: 更新特定便签。
Text Operations:
- create_text_item: 添加文本项目。
- get_text_item: 检索特定文本项目。
- update_text_item: 更新特定文本项目。
Shape Operations:
- create_shape_item: 添加形状项目。
- get_shape_item: 检索特定形状项目。
- update_shape_item: 更新特定形状项目。
Card Operations:
- create_card_item: 添加卡片项目。
- get_card_item: 检索特定卡片项目。
- update_card_item: 更新特定卡片项目。
Connector Operations:
- create_connector: 在项目之间添加连接器。
- get_connectors: 检索连接器列表。
- get_connector: 检索特定连接器。
- update_connector: 更新特定连接器。
- delete_connector: 删除特定连接器。
Document Operations:
- create_document_item_using_url: 从 URL 添加文档项目。
- update_document_item_using_url: 更新从 URL 添加的文档项目。
Embed Operations:
- create_embed_item: 从 URL 添加嵌入项目。
- update_embed_item: 更新嵌入项目。
Image Operations:
- create_image_item_using_url: 从 URL 添加图像项目。
- update_image_item_using_url: 更新从 URL 添加的图像项目。
App Card Operations:
- create_app_card_item: 添加应用卡片项目。
- update_app_card_item: 更新应用卡片项目。
使用教程
使用依赖
- Node.js
- 具有 API 访问权限的 Miro 账户
- Miro API 令牌
- Miro 看板 ID
安装教程（不使用 Docker）
-
克隆仓库：
git clone https://github.com/yourusername/mcp-server-miro.git cd mcp-server-miro -
安装依赖：
npm install -
在根目录创建
.env文件，包含以下变量： ``` MIRO_API_TOKEN=your_miro_api_token MIRO_BOARD_ID=your_miro_board_id
# Optional, port PORT=3000 ```
使用
- 启动服务器：
npm run dev
或
npm run build
npm start
-
服务器将在
http://localhost:8899/sse启动 -
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
调试方式
- 启动服务器后，访问
http://localhost:8899/sse检查服务是否正常运行。 - 使用 API 工具进行测试，确保各功能正常。