Cocos MCP 日志桥接工具

一个强大的日志同步工具，用于在 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 协议以完成日志同步。

基本用法

# 示例代码：如何使用Cocos MCP进行日志操作
from cocos_mcp import log_bridge

# 初始化日志桥接工具
bridge = log_bridge.LogBridge()

# 同步实时日志
def on_log_received(log):
    print(f"接收的日志: {log}")

bridge.start_logging(on_log_received)

# 过滤日志（例如，按类型过滤）
filtered_logs = bridge.filter_logs("error")

# 搜索关键词
search_results = bridge.search_logs("崩溃")

# 清空日志
bridge.clear_logs()

详细文档

有关如何使用此工具的更多信息，请参考以下文档：

• 用户指南: 使用说明
• 开发者指南: 开发文档
• 问题排查: 常见问题解答

技术架构

该项目由以下三个主要部分组成：

1. 日志桥接工具：负责在 Cocos Creator 和 Cursor AI 之间传输日志信息。
2. 过滤模块：支持按类型（如普通日志、警告、错误）进行日志筛选。
3. TCP 通信桥接：提供稳定可靠的通信机制，确保日志传输的高效性和可靠性。

贡献指南

欢迎社区贡献！如果你有任何问题或建议，请参考 贡献指南 或在 GitHub 上提交 issue。

许可证

本项目遵循 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

感谢

感谢以下团队和个人：

• Cocos Creator 团队：提供了强大的游戏引擎支持。
• Cursor AI 团队：开发了优秀的 AI 工具，使集成成为可能。
• 所有贡献者和用户：你们的支持和反馈对项目至关重要。