Cocos MCP Log Bridge
一个强大的日志桥接工具，用于在 Cocos Creator 编辑器和 Cursor AI 之间同步日志信息，帮助开发者更有效地分析和解决问题。
🌟 功能特点
- 实时日志同步: 直接从 Cocos Creator 编辑器获取最新日志
- 智能过滤: 支持按类型过滤（普通日志、警告、错误）
- 关键词搜索: 精确定位特定问题
- 一键清除: 随时清空日志以减少干扰
- 场景信息: 获取当前场景的基本信息和节点列表
- 场景操作: 支持打开场景等基础操作
- TCP 通信桥接: 稳定可靠的通信机制
- Cursor AI 集成: 完全兼容 Cursor MCP 协议
🚀 快速入门
前置条件
- Cocos Creator 3.8.0 或更高版本
- Python 3.7 或更高版本
- uv 包管理器 (推荐) 或 pip
安装步骤
-
克隆仓库
git clone https://github.com/czh2774/cocosMCP.git -
复制到 Cocos Creator 项目
将克隆的
cocosMCP目录复制到你的 Cocos Creator 项目的extensions目录下。 -
安装 Python 依赖
cd your-project/extensions/cocosMCP/Python uv pip install -r requirements.txt -
在 Cocos Creator 中启用扩展
启动 Cocos Creator，进入
扩展 -> 扩展管理器，确保cocosMCP扩展已启用。 -
配置 Cursor AI
在 Cursor AI 设置中配置 MCP 服务器，指向 Python 服务器脚本。
基本用法
# 查询日志
logs = await mcp.query_logs({
"show_logs": True,
"show_warnings": True,
"show_errors": True
})
# 清除日志
await mcp.clear_logs()
# 检查连接状态
status = await mcp.connection_status()
# 获取场景信息
scene_info = await mcp.get_scene_info()
# 列出场景中的所有节点
nodes = await mcp.list_scene_nodes()
# 打开指定UUID的场景
await mcp.open_scene("scene-uuid-here")
📚 详细文档
本项目包含三个详细的文档:
🔧 技术架构
Cocos MCP 由三个主要部分组成:
- Cocos Creator 扩展: TypeScript 编写的编辑器扩展
- TCP 通信桥: 连接编辑器和 Python 服务器
- Python MCP 服务器: 处理 Cursor AI 的请求
🤝 贡献指南
欢迎贡献代码、报告问题或提出新功能建议！请查看 开发者指南 了解详情。
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
🙏 致谢
- Cocos Creator 团队提供的优秀游戏引擎
- Cursor AI 团队开发的智能编程助手
- 所有贡献者和用户的支持和反馈
如有问题或建议，请提交 Issues。