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 工具，使集成成為可能。
• 所有貢獻者和用戶：你們的支持和反饋對項目至關重要。