Cocosmcp

🚀 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。

📦 安装指南

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 工具，使集成成为可能。
• 所有贡献者和用户：你们的支持和反馈对项目至关重要。