Miro Rust远程MCP服务器
用于Miro板操作的生产就绪模型上下文协议（MCP）服务器，内置于Rust中，具有OAuth2身份验证。使Claude AI能够以编程方式创建和管理Miro董事会，特别关注可视化敏捷的团队组织结构。
特性
- OAuth资源服务器模式：Claude处理OAuth，服务器验证承载令牌（RFC 9728）
- 内存令牌缓存：缓存命中率95%，验证延迟\ “创建一个Miro板，显示3个敏捷小组（Alpha、Beta、Gamma）。每个小组有1个产品负责人、1个Scrum Master和5个开发人员。显示团队成员向Scrum Master的汇报关系。”
MCP服务器将：
- 创建新板
- 为每个小队创建框架
- 为团队成员创建颜色编码的便签（PO=黄色，SM=绿色，Dev=蓝色）
- 创建显示报告关系的连接器
- 返回板URL
通过自然语言在5分钟内完成！
API 文档
米罗API v2
- 基础URL:
https://api.miro.com/v2/ - 认证：承载令牌（OAuth2）
- 速率限制：每个用户每分钟100个请求
- 文档: https://developers.miro.com/docs/rest-api-reference
MCP协议
- 规格说明: https://modelcontextprotocol.io/
- 运输：stdio（Claude.ai web界面）或HTTP
- 框架：rmcp（官方Rust SDK）
故障排除
“找不到配置文件”
- 确保配置目录存在：
mkdir -p ~/.config/mcp/miro-rust - 复制示例配置：
cp config.example.json ~/.config/mcp/miro-rust/config.json - 使用您的凭据编辑配置：
nano ~/.config/mcp/miro-rust/config.json
“身份验证失败”
- 检查
client_id和client_secret在~/.config/mcp/miro-rust/config.json - 验证
redirect_uri与Miro应用程序配置完全匹配 - 检查令牌尚未过期（应自动刷新）
“令牌加密失败”
- 确保
encryption_key正好是64个十六进制字符（32字节） - 生成新密钥：
openssl rand -hex 32 - 在中更新它
~/.config/mcp/miro-rust/config.json
“超出费率限制”
- Miro API限制：100次请求/分钟
- 等待60秒，然后重试
- 考虑对大型可视化进行批量操作
贡献
- 分叉存储库
- 创建特征分支(
git checkout -b feat/amazing-feature) - 遵循Rust约定（运行
cargo fmt和cargo clippy) - 为新功能编写测试
- 确保所有测试通过(
cargo test) - 以传统格式提交(
feat:,fix:,refactor:) - 推送并创建拉取请求
路线图
冲刺1（完成）✅
- \[x\] OAuth2授权与PKCE
- \[x\] 自动令牌刷新
- \[x\] 董事会列表和创建
- \[x\] 视觉元素创建（便签、形状、文本、框架）
Sprint 2（进行中）
- \[\]项目管理（列表、更新、删除）
- \[\]创建带有标题的连接器
- \[\]小队可视化编排
Sprint 3（计划中）
- \[\]批量操作以提高性能
- \[\]生产部署指南
- \[\]Claude.ai web界面集成测试
许可证
MIT许可证-有关详细信息，请参阅许可证文件
致谢
- Miro API v2，用于全面的板操作
- 用于AI原生工具集成的MCP协议
- 用于清洁MCP实现的rmcp-Rust SDK
- oauth2-rs用于健壮的oauth2客户端
- Claude Code开发平台的拟人化
支持
- 问题: https://github.com/yourusername/miro-rust-remote-mcp/issues
- Miro API文件: https://developers.miro.com/docs
- MCP规范: https://modelcontextprotocol.io/
______________________________________________________________________
内置于❤️ 在Rust中|由OAuth2提供技术支持|由AES-256-GCM保护