React Native Godot MCP

🚀 React Native Godot Documentation MCP Server

強力なModel Context Protocol (MCP)サーバーです。React Native Godotのドキュメント、サンプルコード、実装ガイドをインテリジェントにアクセスすることができます。このサーバーにより、LLMはreact-native-godotリポジトリ（Born.comとMigeranによるもの）からドキュメントを効率的に取得し、検索することが可能です。

🚀 クイックスタート

このMCPサーバーを使って、React Native Godotのドキュメントやサンプルコードを簡単に取得できます。以下のセクションでは、インストール方法、使い方、その他の詳細を説明します。

✨ 主な機能

エージェント中心の設計

このMCPサーバーは、エージェント指向のツール設計のベストプラクティスに従っています。

• ワークフロー中心のツール：APIのラッピングだけでなく、完全なタスクを実行できます。
• コンテキスト効率の最適化：詳細レベルを設定可能です。
• 実行可能なエラーメッセージ：エージェントが問題を解決する手助けになります。
• 自然なタスク分割：直感的なツール名を持ちます。

利用可能なツール

📖 get_documentation

React Native Godotのドキュメントの特定のセクションを取得します。

• 概要、インストール、初期化
• APIの使用方法、スレッディング、ビュー
• エクスポート、デバッグ、カスタムビルド
• 詳細レベルを設定可能（簡潔/詳細/完全）

🔍 search_documentation

すべてのドキュメントをインテリジェントに検索します。

• キーワードベースの検索で、関連性スコア付き
• 最も関連するセクションを返します
• 特定のトピックを見つけるか、トラブルシューティングに最適

💻 get_example_code

以下の作動するコード例を取得します。

• 初期化とセットアップ
• APIの使用パターン
• シグナルハンドリング
• ビューの埋め込み
• ワークレットとスレッディング
• 完全なアプリケーションの例

🛠️ get_setup_instructions

プラットフォーム固有のセットアップガイダンスを提供します。

• iOSとAndroidの設定
• デバッグのセットアップオプション
• カスタムビルドの手順
• ステップバイステップのインストールプロセス

📚 get_api_reference

以下の詳細なAPIドキュメントを取得します。

• RTNGodotクラスのメソッド
• RTNGodotViewコンポーネント
• runOnGodotThread関数
• シグナルと呼び出し可能オブジェクト
• プロパティアクセスパターン

🔧 get_troubleshooting

一般的な問題の解決策を提供します。

• ビルドエラー
• ビューの表示問題
• スレッディングの問題
• エクスポートの問題
• パフォーマンスの最適化

📁 get_file_from_repo

リポジトリのファイルに直接アクセスします。

• サンプル実装
• 設定ファイル
• ビルドスクリプト
• ネイティブコード

📦 インストール

前提条件

# Python 3.8+
python --version

# MCPとFastMCPをインストール
pip install mcp fastmcp

依存関係のインストール

pip install httpx pydantic

実行可能にする

chmod +x react_native_godot_mcp.py

💻 使用例

サーバーの起動

スタンドアロンモード

python react_native_godot_mcp.py

MCPインスペクターを使用する場合（テスト用）

npx @modelcontextprotocol/inspector python react_native_godot_mcp.py

Claude Desktopとの統合

Claudeの設定ファイルに追加します。

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "react-native-godot": {
      "command": "python",
      "args": ["/path/to/react_native_godot_mcp.py"],
      "env": {}
    }
  }
}

他のMCPクライアントとの統合

このサーバーはstdioトランスポートを使用しており、MCP互換のクライアントと統合できます。

# 例：Pythonクライアントの使用
from mcp import Client

client = Client()
client.connect_stdio(["python", "react_native_godot_mcp.py"])

# ツールを使用
result = await client.call_tool(
    "get_documentation",
    {"section": "initialization", "detail": "detailed"}
)

基本的な使用法

# React Native Godotの使い始め方
# インストール手順を取得
get_setup_instructions(platform="both", include_debugging=True)

# 初期化の例を取得
get_example_code(topic="initialization", platform="ios")

高度な使用法

# 特定のトピックを検索
# ワークレットの情報を検索
search_documentation(query="worklets threading", max_results=5)

# シグナルハンドリングのドキュメントを検索
search_documentation(query="connect signals JavaScript")

# 問題のトラブルシューティング
# ビルドエラーのヘルプを取得
get_troubleshooting(issue="build_error", platform="android")

# ビューの問題をデバッグ
get_troubleshooting(issue="view_not_showing")

# APIの詳細を調べる
# RTNGodotのAPIリファレンスを取得
get_api_reference(topic="RTNGodot", include_examples=True)

# シグナルについて学ぶ
get_api_reference(topic="signals")

🧪 評価の実行

リポジトリには、MCPサーバーの機能をテストするための包括的な評価問題が含まれています。

評価ファイルの使用

1. 評価ファイル (react_native_godot_evaluation.xml) には10の複雑な問題が含まれています。
2. 各問題は、サーバーが特定の情報を見つける能力をテストします。
3. 問題は、初期化、スレッディング、デバッグ、APIの使用などをカバーしています。

MCPを使用した評価の実行

# 評価ツールをインストール
pip install mcp-eval

# 評価を実行
mcp-eval run react_native_godot_mcp.py react_native_godot_evaluation.xml

手動テスト

各ツールを手動でテストすることができます。

# ドキュメントの取得をテスト
python -c "
import asyncio
from react_native_godot_mcp import get_documentation

async def test():
    result = await get_documentation(None, 'threading', 'markdown', 'detailed')
    print(result)

asyncio.run(test())
"

🔧 技術詳細

設計原則

1. ワークフロー指向：ツールは一般的な開発者のワークフローを中心に設計されています。
2. コンテキスト認識：トークンの使用を最適化するために、詳細レベルを調整可能です。
3. エラー耐性：実行可能なエラーメッセージでエラーを適切に処理します。
4. 形式柔軟性：MarkdownとJSONの両方のレスポンス形式をサポートします。

レスポンス形式

すべてのツールは、2つのレスポンス形式をサポートしています。

• Markdown：人間が読みやすい、フォーマットされたドキュメント
• JSON：プログラムで使用するための構造化データ

詳細レベル

ドキュメントには3つの詳細レベルがあります。

• 簡潔：要点とヘッダーのみ
• 詳細：サンプル付きの標準的なドキュメント
• 完全：すべての詳細を含む完全な内容

🔒 セキュリティと制限

• 文字制限：レスポンスあたり25,000文字
• リクエストタイムアウト：30秒
• 最大検索結果数：クエリあたり20件
• レート制限：GitHub APIの制限を尊重します。

🤝 コントリビューション

このMCPサーバーは拡張可能に設計されています。新しい機能を追加するには、以下の手順を実行します。

1. @mcp.toolデコレーターを使用して新しいツールメソッドを追加します。
2. 検証用のPydantic入力モデルを定義します。
3. 既存のエラーハンドリングのパターンに従います。
4. 対応する評価問題を追加します。

📄 ライセンス

MITライセンス - React Native Godotと同じ

🙏 クレジット

• React Native Godot：BornとMigeranによって作成されました。
• MCPサーバー：AnthropicのModel Context Protocolを使用して構築されました。
• FastMCP：簡略化されたMCP開発フレームワーク

📞 サポート

React Native Godotに関する質問については、以下の場所を参照してください。

• GitHub Issues
• Migeran Support（商用）

MCPサーバーに関する問題については、このリポジトリに問題を開いてください。また、能力検証のために評価結果を確認してください。

🚦 ステータス

• ✅ すべてのドキュメントセクションにアクセス可能
• ✅ インテリジェントな検索機能
• ✅ 完全なサンプルコードのカバレッジ
• ✅ プラットフォーム固有のガイダンス
• ✅ 包括的なトラブルシューティング
• ✅ リポジトリからの直接ファイルアクセス
• ✅ テスト用の10の評価問題

React NativeとGodotコミュニティのために❤️で作られました