Cocos MCP 日志桥接工具

一个强大的日志桥接工具，用于在Cocos Creator编辑器和光标AI之间同步日志信息，帮助开发者更有效地分析和解决问题。

🌟 功能特性

• 实时日志同步：直接从Cocos Creator编辑器获取最新日志。
• 智能过滤：支持按类型（常规日志、警告、错误）进行过滤。
• 关键词搜索：准确定位特定问题。
• 一键清除：随时清除日志以减少干扰。
• 场景信息：获取当前场景的基本信息和节点列表。
• 场景操作：支持打开场景等基本操作。
• TCP通信桥接：稳定可靠的通信机制。
• Cursor AI 集成：完全兼容cursor MCP协议。

🚀 快速开始

前提条件

• Cocos Creator 3.8.0或更高版本
• Python版本3.7或更高版本
• UV包管理器（推荐）或pip

安装步骤

1. 克隆仓库

   git clone https://github.com/czh2774/cocosMCP.git
   

2. 复制到Cocos Creator项目

   将克隆的cocosMCP目录复制到你的Cocos Creator项目的extensions目录下。

3. 安装Python依赖

   cd your-project/extensions/cocosMCP/Python
   uv pip install -r requirements.txt
   

4. 启用Cocos Creator扩展

   启动Cocos Creator并进入扩展 -> 扩展管理器，确保已启用cocosMCP扩展。

5. 配置Cursor AI

   在Cursor AI设置中配置MCP服务器，并指向Python服务器脚本。

使用方法

# 查询日志
logs = await mcp.query_logs({
    "show_logs": True,
    "show_warnings": True,
    "show_errors": True
})

# 清除日志
await m_清空日志pc.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由三个主要部分组成：

1. Cocos Creator 扩展：用TypeScript编写的编辑器扩展
2. TCP通信桥接：连接编辑器和Python服务器
3. Python MCP服务器：处理来自Cursor AI的请求

🤝 贡献指南

欢迎贡献代码、报告问题或提供新功能建议！请参阅开发者指南了解详情。

📄 许可证

本项目采用MIT许可证——请参阅LICENSE文档获取更多信息。

🙏 致谢

• Cocos Creator团队提供的优秀游戏引擎
• Cursor AI团队开发的智能编程助手
• 所有贡献者和用户的反馈和支持

---

如有任何疑问或建议，请提交问题。