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()

📚 ドキュメント

このツールの使用方法に関する詳細情報は、以下のドキュメントを参照してください。

• ユーザーガイド：使用説明
• 開発者ガイド：開発文書
• 問題解決：FAQ

🔧 技術詳細

このプロジェクトは、以下の3つの主要な部分で構成されています。

1. ログブリッジツール：Cocos Creator と Cursor AI の間でログ情報を転送する役割を果たします。
2. フィルタリングモジュール：タイプ（通常のログ、警告、エラー）でのログのフィルタリングをサポートします。
3. TCP 通信ブリッジ：安定した信頼性の高い通信メカニズムを提供し、ログ転送の効率と信頼性を確保します。

🤝 貢献ガイド

コミュニティの貢献を歓迎します！何か問題や提案がある場合は、貢献ガイド を参照するか、GitHub で issue を提出してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。詳細については、LICENSE ファイル を参照してください。

🙏 感謝

以下のチームと個人に感謝します。

• Cocos Creator チーム：強力なゲームエンジンのサポートを提供してくれました。
• Cursor AI チーム：優れた AI ツールを開発し、統合を可能にしてくれました。
• すべての貢献者とユーザー：あなた方のサポートとフィードバックは、このプロジェクトにとって非常に重要です。