MCP Miro Server

集成到Miro平台的模型上下文协议(MCP)服务器。它使AI助手（如Claude）能够通过标准化接口访问Miro白板并管理其内容。

---

要求

• 安装了Node.js v16或更高版本
• 带有API令牌的Miro账户

生成Miro访问令牌

1. 访问Miro开发者门户
2. 创建一个新应用或使用现有应用
3. 确保创建具有以下权限的令牌
4. 通过选择安装应用并获取OAuth令牌来生成OAuth令牌

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

连接至Claude桌面

1. 安装Claude桌面

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桌面

---

可用工具和资源

工具

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许可证2.0

本项目根据Apache许可证2.0版进行许可。详情见LICENSE文件。