Miro Extension for Model Context Protocol (MCP)

Miro Extension for Model Context Protocol (MCP)

site icon
2025.03.26 0
TypeScriptAI辅助设计团队协作数据可视化交流协作
Miro Extension for Model Context Protocol (MCP) 是一个扩展工具,使AI代理能够通过Model Context Protocol (MCP)与Miro白板进行交互。它提供了高级功能,用于操作和从Miro白板中提取数据,是AI辅助设计、协作和数据可视化的强大工具。
View on GitHub

Overview

基本能力

产品定位

Miro Extension for Model Context Protocol (MCP) 是一个扩展工具,使AI代理能够通过Model Context Protocol (MCP)与Miro白板进行交互。它提供了高级功能,用于操作和从Miro白板中提取数据,是AI辅助设计、协作和数据可视化的强大工具。

核心功能

  • 图像工具
  • 通过URL在Miro白板上创建图像
  • 使用base64编码数据上传图像
  • 支持定位和调整大小
  • Iframe嵌入
  • 将iframe嵌入到Miro白板中(网站、视频等)
  • 控制显示模式(内联/模态)
  • 为嵌入内容设置预览图像
  • 白板数据导出
  • 以JSON格式导出整个白板数据
  • 获取白板项目的详细信息
  • 查看完整的白板结构和内容
  • 形状数据提取
  • 获取特定形状的详细信息
  • 提取位置、尺寸和样式
  • 按类型查询白板上的形状

适用场景

  • AI辅助设计
  • 团队协作
  • 数据可视化

工具列表

  • 图像工具
  • create_image_from_url:通过URL在Miro白板上创建图像
  • create_image_from_base64:通过base64编码数据在Miro白板上创建图像
  • Iframe嵌入
  • create_embed:在Miro白板上嵌入iframe
  • 白板数据导出
  • export_board_as_json:以JSON格式导出所有白板数据
  • get_shape_data:获取白板上特定项目的详细数据
  • 形状数据提取
  • get_shape_details:获取特定形状的详细信息
  • get_shapes_by_type:获取白板上特定类型的所有形状

常见问题解答

  • 该扩展解决了Miro API的一些限制(例如,没有直接的截图API),通过提供可用于重新创建或可视化白板的全面数据。
  • 所有API调用都包括强大的错误处理和响应验证。
  • 代码库完全使用TypeScript进行类型化,以获得更好的开发体验和代码质量。

使用教程

使用依赖

# Clone the repository
git clone <repository-url>

# Install dependencies
npm install

安装教程

# Clone the repository
git clone <repository-url>

# Install dependencies
npm install

调试方式

# Start the server with Miro OAuth token
npm start -- --miro-token YOUR_TOKEN_HERE

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。