Glama
Sign In

Cocos MCP Log Bridge

by czh2774
Verified
npmGitHub
Python
MIT License
121
1
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Bridges log information between Cocos Creator editor and Cursor AI, allowing real-time log synchronization, filtering by log type, and keyword searching to help developers analyze and solve problems more effectively.

  • Integrates with Cocos Creator's TypeScript-based editor extension system to capture and relay logs through the MCP bridge.

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。

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

A powerful log bridging tool that synchronizes log information between Cocos Creator editor and Cursor AI, helping developers analyze and solve problems more effectively.

  1. 🌟 功能特点
    1. 🚀 快速入门
      1. 前置条件
      2. 安装步骤
      3. 基本用法
    2. 📚 详细文档
      1. 🔧 技术架构
        1. 🤝 贡献指南
          1. 📄 许可证
            1. 🙏 致谢