MCP Miro Server

MCP Miro 服务

与 Miro 平台集成的 Model Context Protocol (MCP) 服务。它使 AI 助手（如 Claude）能够通过标准化接口访问 Miro 白板并管理其内容。

---

要求

• 已安装 Node.js v16 或更高版本
• 拥有 Miro 账号和 API 令牌

生成 Miro 访问令牌

1. 前往 Miro Developer Portal
2. 创建新应用或使用现有应用
3. 确保创建令牌时勾选下方所列的权限
4. 选择 Install app and get OAuth token 生成 OAuth 令牌

权限	必需
boards:read	✅
boards:write	✅
identity:read	✅
identity:write	✅
team:read	✅
team:write	✅
microphone:listen	❌
screen:record	❌
webcam:record	❌
auditlogs:read	❌
sessions:delete	❌

连接 Claude Desktop

1. 安装 Claude Desktop

2. 打开或创建配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 更新配置以包含此服务：

{
   "mcpServers":{
      "miro":{
         "command":"npx",
         "args":[
            "-y",
            "@k-jarzyna/mcp-miro"
         ],
         "env":{
            "MIRO_ACCESS_TOKEN":"your_miro_access_token"
         }
      }
   }
}

4. 重启 Claude Desktop

---

可用工具和资源

工具

Miro SDK 函数	MCP 工具	可用
列出看板	list-boards	✅
创建看板	create-board	✅
更新看板	update-board	✅
删除看板	delete-board	✅
复制看板	copy-board	✅
获取指定看板	get-specific-board	✅
获取看板上的项目	get-items-on-board	✅
获取指定项目	get-specific-item	✅
更新项目位置	update-item-position	✅
删除项目	delete-item	✅
创建应用卡片项目	create-app-card-item	✅
获取应用卡片项目	get-app-card-item	✅
更新应用卡片项目	update-app-card-item	✅
删除应用卡片项目	delete-app-card-item	✅
创建卡片项目	create-card-item	✅
获取卡片项目	get-card-item	✅
更新卡片项目	update-card-item	✅
删除卡片项目	delete-card-item	✅
创建连接器	create-connector	✅
获取连接器	get-connectors	✅
获取指定连接器	get-specific-connector	✅
更新连接器	update-connector	✅
删除连接器	delete-connector	✅
创建便签项目	create-sticky-note-item	✅
获取便签项目	get-sticky-note-item	✅
更新便签项目	update-sticky-note-item	✅
删除便签项目	delete-sticky-note-item	✅
创建框架	create-frame	✅
获取框架项目	get-frame-item	✅
更新框架项目	update-frame-item	✅
删除框架项目	delete-frame-item	✅
创建文档项目	create-document-item	✅
获取文档项目	get-document-item	✅
更新文档项目	update-document-item	✅
删除文档项目	delete-document-item	✅
创建文本项目	create-text-item	✅
获取文本项目	get-text-item	✅
更新文本项目	update-text-item	✅
删除文本项目	delete-text-item	✅
批量创建项目	create-items-in-bulk	✅
使用 URL 创建图像项目	create-image-item-using-url	✅
使用文件创建图像项目	create-image-item-using-file	✅
获取图像项目	get-image-item	✅
更新图像项目	update-image-item	✅
使用文件更新图像项目	update-image-item-using-file	✅
删除图像项目	delete-image-item	✅
创建形状项目	create-shape-item	✅
获取形状项目	get-shape-item	✅
更新形状项目	update-shape-item	✅
删除形状项目	delete-shape-item	✅
创建嵌入项目	create-embed-item	✅
获取嵌入项目	get-embed-item	✅
更新嵌入项目	update-embed-item	✅
删除嵌入项目	delete-embed-item	✅
创建标签	create-tag	✅
获取标签	get-tag	✅
获取所有标签	get-all-tags	✅
更新标签	update-tag	✅
删除标签	delete-tag	✅
附加标签	attach-tag	✅
移除标签	detach-tag	✅
获取项目标签	get-item-tags	✅
获取所有看板成员	get-all-board-members	✅
获取指定看板成员	get-specific-board-member	✅
移除看板成员	remove-board-member	✅
共享看板	share-board	✅
更新看板成员	update-board-member	✅
创建群组	create-group	✅
获取所有群组	get-all-groups	✅
获取群组	get-group	✅
获取群组项目	get-group-items	✅
更新群组	update-group	✅
取消项目分组	ungroup-items	✅
删除群组	delete-group	✅
使用文件批量创建项目	create-items-in-bulk-using-file	✅
创建思维导图节点	create-mindmap-node	✅
获取思维导图节点	get-mindmap-node	✅
获取思维导图节点列表	get-mindmap-nodes	✅
删除思维导图节点	delete-mindmap-node	✅
添加项目成员	add-project-member	✅
创建看板导出任务	create-board-export-job	✅
获取所有案件	get-all-cases	✅
获取所有法律保留项	get-all-legal-holds	✅
获取审计日志	get-audit-logs	✅
获取看板分类	get-board-classification	✅
获取看板内容日志	get-board-content-logs	✅
获取看板导出任务结果	get-board-export-job-results	✅
获取看板导出任务状态	get-board-export-job-status	✅
获取案件	get-case	✅
获取法律保留项	get-legal-hold	✅
获取法律保留内容项目	get-legal-hold-content-items	✅
获取组织信息	get-organization-info	✅
获取组织成员	get-organization-member	✅
获取组织成员列表	get-organization-members	✅
获取项目成员	get-project-member	✅
移除项目成员	remove-project-member	✅
更新看板分类	update-board-classification	✅

---

本地开发

1. 安装依赖：

npm install

2. 根据模板创建 .env 文件：

cp .env.template .env

3. 编辑 .env 文件并添加你的 Miro 访问令牌

4. 构建服务：

npm run build

运行服务

运行服务：

node build/index.js

---

许可证

Apache License 2.0

本项目根据 Apache License 2.0 版授权。详情请参阅 LICENSE 文件。