Tigergraph

🚀 TG_MCP

TG_MCPは、TigerGraphの操作（クエリ、スキーマ、頂点、エッジ、UDF）を構造化されたツールとURIベースのリソースとしてMCPエージェントに公開する軽量なPythonインターフェースです。

🚀 クイックスタート

このセクションでは、TG_MCPの基本的な使い方を説明します。まずは、インストールと設定を行い、その後に簡単な使用例を見ていきましょう。

✨ 主な機能

• スキーマのイントロスペクション
  完全なグラフスキーマ（頂点とエッジのタイプ）を取得します。

• クエリの実行
  インストールされたGSQLクエリまたはパラメータ付きの生のGSQL文字列でクエリを実行します。

• 頂点とエッジの挿入/更新
  頂点とエッジを作成または更新します。

• リソースURI
  tgraph://vertex/... および tgraph://query/... URIを介してグラフオブジェクトにアクセスします。

• UDFとアルゴリズムのリスト
  インストールされたユーザー定義関数とGDSアルゴリズムのディレクトリを取得します。

📦 インストール

1. リポジトリをクローンします：

git clone [仓库地址]
cd TG_MCP

2. 仮想環境を作成してアクティブ化します（推奨）：

python -m venv env
source env/bin/activate  # Windowsでは`env\Scripts\activate`を使用

3. 依存関係をインストールします：

pip install -r requirements.txt

📚 ドキュメント

設定

以下の環境変数を設定します：

• TG_HOST: TigerGraphインスタンスのアドレス（例：http://localhost:14200）
• TG_GRAPH: 操作対象のグラフ名
• TG_SECRET: TigerGraph REST APIのアクセスキー

例：

export TG_HOST="http://localhost:14200"
export TG_GRAPH="my_graph"
export TG_SECRET="your_api_secret_key"

Claudeへの接続

このMCPサーバーをClaude Desktopに接続するには、以下の手順を実行します：

1. インストールが完了したら、以下のコマンドを実行します：

python -m tg_mcp.main install

2. Claude Desktopでクライアントを再起動して変更を適用します。

💻 使用例

基本的な使用法

# グラフ構造の例
from tg_mcp import TGClient

client = TGClient()
# 頂点とエッジのスキーマ定義を取得
schema = client.get_schema()
print(schema)

高度な使用法

# クエリの例
result = client.execute_query("MATCH (a) RETURN a LIMIT 1")
print(result)

プロジェクト構造

TG_MCP/
├── config.py            # 環境設定（HOST, GRAPH, SECRET）
├── tg_client.py         # TigerGraphConnectionと核心操作をラップ
├── tg_tools.py          # `@mcp.tool`定義，クライアントメソッドを公開
├── tg_resources.py      # `@mcp.resource` URIハンドラ
├── README.md            # プロジェクトの説明ドキュメント
└── requirements.txt     # 依存関係のリスト

貢献方法

このプロジェクトに貢献するには、以下の手順に従ってください：

1. このリポジトリをForkします。
2. 機能ブランチを作成します：git checkout -b feature/your-feature-name
3. 変更をコミットします：git add . && git commit -m "你的提交信息"
4. リモートリポジトリにプッシュします：git push origin feature/your-feature-name
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトは[许可证名称]の下でライセンスされています。詳細については、LICENSEファイルを参照してください。