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

安装步骤

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 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 由三个主要部分组成:

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

🤝 贡献指南

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

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

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

如有问题或建议，请提交 Issues。