cocosMCP
3.4
If you are the rightful owner of cocosMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Cocos MCP Log Bridge is a powerful tool for synchronizing log information between Cocos Creator and Cursor AI, aiding developers in effective problem analysis and resolution.
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 许可证 - 详情请参阅 文件。
🙏 致谢
- Cocos Creator 团队提供的优秀游戏引擎
- Cursor AI 团队开发的智能编程助手
- 所有贡献者和用户的支持和反馈
如有问题或建议，请提交 Issues。
