🚀 Cocos MCP 日志桥接工具
Cocos MCP 日志桥接工具是一款强大的日志同步工具，可在 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 协议以完成日志同步。
💻 使用示例
基础用法
# 示例代码：如何使用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()
📚 详细文档
有关如何使用此工具的更多信息，请参考以下文档：
🔧 技术细节
该项目由以下三个主要部分组成：
- 日志桥接工具：负责在 Cocos Creator 和 Cursor AI 之间传输日志信息。
- 过滤模块：支持按类型（如普通日志、警告、错误）进行日志筛选。
- TCP 通信桥接：提供稳定可靠的通信机制，确保日志传输的高效性和可靠性。
贡献指南
欢迎社区贡献！如果你有任何问题或建议，请参考 贡献指南 或在 GitHub 上提交 issue。
📄 许可证
本项目遵循 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。
感谢
感谢以下团队和个人：
- Cocos Creator 团队：提供了强大的游戏引擎支持。
- Cursor AI 团队：开发了优秀的 AI 工具，使集成成为可能。
- 所有贡献者和用户：你们的支持和反馈对项目至关重要。