Cocos MCP Log Bridge
A powerful log bridging tool that synchronizes log information between Cocos Creator editor and Cursor AI, helping developers analyze and solve problems more effectively.
README
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
安装步骤
-
克隆仓库
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 服务器，指向 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 由三个主要部分组成:
- Cocos Creator 扩展: TypeScript 编写的编辑器扩展
- TCP 通信桥: 连接编辑器和 Python 服务器
- Python MCP 服务器: 处理 Cursor AI 的请求
🤝 贡献指南
欢迎贡献代码、报告问题或提出新功能建议！请查看 开发者指南 了解详情。
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
🙏 致谢
- Cocos Creator 团队提供的优秀游戏引擎
- Cursor AI 团队开发的智能编程助手
- 所有贡献者和用户的支持和反馈
如有问题或建议，请提交 Issues。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.