Raphtory GraphQL Schema Explorer

🚀 Raphtory GraphQL Schema Explorer 日本語ドキュメント

このPythonモジュールは、FastMCPサーバーを提供し、一連のHTTPリソースを通じてRaphtoryグラフのGraphQLスキーマ情報を公開します。LLMがグラフの構造（ノード属性や関係タイプを含む）を探索し理解することを可能にします。

✨ 主な機能

1. グラフスキーマのクエリ

• 特定のグラフ名のスキーマをクエリする
• ノード属性の詳細情報を取得する
• 一意の関係タイプとそのメタデータを取得する
• オプションで属性バリエーションを含める

2. リソース

schema://database

データベースの完全なGraphQLスキーマを返します。以下を含みます：

• すべての利用可能なタイプ
• 各タイプのフィールド
• フィールドの説明
• パラメータとそのデフォルト値

schema://graph_exists/{graph_name}

ノードの存在を確認することで、特定のグラフがデータベースに存在するかどうかを検証します。

schema://{graph_name}/{include_variants}

特定のグラフの詳細なスキーマ情報を返します：

• ノード属性：
  • 属性キー
  • 属性タイプ（例："Str"）
  • オプションの属性バリエーション
• 関係：
  • 一意の関係タイプ（例："edge_type_1"、"edge_type_2"、"edge_type_3"）

3. 実装の詳細

このモジュールは以下を使用しています：

• 稼働中のRaphtory GraphQLサーバー（起動が必要）
• HTTP/2をサポートするhttpx非同期HTTPリクエスト
• FastMCPによるリソース管理
• グローバルな非同期クライアントの永続的な接続
• リソースを適切にクリーンアップするためのコンテキスト管理

💻 使用例

基本的な使用法

{
  graph(path: "your_graph_name") {
    schema {
      nodes {
        properties {
          key
          propertyType
        }
      }
    }
    edges {
      list {
        properties {
          keys
          values {
            value
          }
        }
      }
    }
  }
}

🔧 技術詳細

レスポンス形式

スキーマのレスポンスには、以下のような値が含まれます：

{
  "data": {
    "graph": {
      "schema": {
        "nodes": [{
          "properties": [
            {"key": "name", "propertyType": "Str"},
            {"key": "type", "propertyType": "Str"}
            // ... その他の属性
          ]
        }]
      },
      "relationships": [
        "edge_type_1",
        "edge_type_2",
        "edge_type_3"
      ]
    }
  }
}

エラー処理

このモジュールには以下のエラー処理が含まれています：

• 存在しないグラフ
• 無効なクエリ
• 接続問題
• レスポンス形式のエラー

依存関係

• FastMCP
• httpx
• Python 3.x
• 稼働中のRaphtory GraphQLエンドポイント（デフォルト：http://localhost:1736/）

設定

このモジュールは以下のデフォルト設定を使用します：

• HTTP/2が有効
• 10秒のタイムアウト
• Content-Type: application/json

また、環境変数を使用して、認証などの追加設定を行うこともできます。