MCP Miro 服务器

模型上下文协议 (MCP) 服务器，与 Miro 平台集成。它使 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 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	list-boards	✅
Create board	create-board	✅
Update board	update-board	✅
Delete board	delete-board	✅
Copy board	copy-board	✅
Get specific board	get-specific-board	✅
Get items on board	get-items-on-board	✅
Get specific item	get-specific-item	✅
Update item position	update-item-position	✅
Delete item	delete-item	✅
Create app card item	create-app-card-item	✅
Get app card item	get-app-card-item	✅
Update app card item	update-app-card-item	✅
Delete app card item	delete-app-card-item	✅
Create card item	create-card-item	✅
Get card item	get-card-item	✅
Update card item	update-card-item	✅
Delete card item	delete-card-item	✅
Create connector	create-connector	✅
Get connectors	get-connectors	✅
Get specific connector	get-specific-connector	✅
Update connector	update-connector	✅
Delete connector	delete-connector	✅
Create sticky note item	create-sticky-note-item	✅
Get sticky note item	get-sticky-note-item	✅
Update sticky note item	update-sticky-note-item	✅
Delete sticky note item	delete-sticky-note-item	✅
Create frame	create-frame	✅
Get frame item	get-frame-item	✅
Update frame item	update-frame-item	✅
Delete frame item	delete-frame-item	✅
Create document item	create-document-item	✅
Get document item	get-document-item	✅
Update document item	update-document-item	✅
Delete document item	delete-document-item	✅
Create text item	create-text-item	✅
Get text item	get-text-item	✅
Update text item	update-text-item	✅
Delete text item	delete-text-item	✅
Create items in bulk	create-items-in-bulk	✅
Create image item using URL	create-image-item-using-url	✅
Create image item using file	create-image-item-using-file	✅
Get image item	get-image-item	✅
Update image item	update-image-item	✅
Update image item using file	update-image-item-using-file	✅
Delete image item	delete-image-item	✅
Create shape item	create-shape-item	✅
Get shape item	get-shape-item	✅
Update shape item	update-shape-item	✅
Delete shape item	delete-shape-item	✅
Create embed item	create-embed-item	✅
Get embed item	get-embed-item	✅
Update embed item	update-embed-item	✅
Delete embed item	delete-embed-item	✅
Create tag	create-tag	✅
Get tag	get-tag	✅
Get all tags	get-all-tags	✅
Update tag	update-tag	✅
Delete tag	delete-tag	✅
Attach tag	attach-tag	✅
Detach tag	detach-tag	✅
Get item tags	get-item-tags	✅
Get all board members	get-all-board-members	✅
Get specific board member	get-specific-board-member	✅
Remove board member	remove-board-member	✅
Share board	share-board	✅
Update board member	update-board-member	✅
Create group	create-group	✅
Get all groups	get-all-groups	✅
Get group	get-group	✅
Get group items	get-group-items	✅
Update group	update-group	✅
Ungroup items	ungroup-items	✅
Delete group	delete-group	✅
Create items in bulk using file	create-items-in-bulk-using-file	✅
Create mindmap node	create-mindmap-node	✅
Get mindmap node	get-mindmap-node	✅
Get mindmap nodes	get-mindmap-nodes	✅
Delete mindmap node	delete-mindmap-node	✅
Add project member	add-project-member	✅
Create board export job	create-board-export-job	✅
Get all cases	get-all-cases	✅
Get all legal holds	get-all-legal-holds	✅
Get audit logs	get-audit-logs	✅
Get board classification	get-board-classification	✅
Get board content logs	get-board-content-logs	✅
Get board export job results	get-board-export-job-results	✅
Get board export job status	get-board-export-job-status	✅
Get case	get-case	✅
Get legal hold	get-legal-hold	✅
Get legal hold content items	get-legal-hold-content-items	✅
Get organization info	get-organization-info	✅
Get organization member	get-organization-member	✅
Get organization members	get-organization-members	✅
Get project member	get-project-member	✅
Remove project member	remove-project-member	✅
Update board classification	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, Version 2.0 获得许可。 有关详细信息，请参见 LICENSE 文件。