TG_MCP

TigerGraph 操作 (クエリ、スキーマ、頂点、エッジ、UDF) を MCP エージェントの構造化ツールおよび URI ベースのリソースとして公開する軽量 Python インターフェイス。

目次

1. 特徴

2. プロジェクト構造

3. インストール

4. 構成

5. クロードへの接続

6. 例

7. 貢献

8. ライセンス

Related MCP server: buddy

特徴

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

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

• 頂点とエッジのアップサート
  プログラムによって頂点とエッジを作成または更新します。

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

• UDFとアルゴリズムのリスト
  インストールされているユーザー定義関数と GDS アルゴリズム カタログを取得します。

プロジェクト構造

TG_MCP/
├── config.py            # Environment config (HOST, GRAPH, SECRET)
├── tg_client.py         # Encapsulates TigerGraphConnection and core operations
├── tg_tools.py          # `@mcp.tool` definitions exposing client methods
├── tg_resources.py      # `@mcp.resource` URI handlers
├── main.py              # MCP app bootstrap (`mcp.run()`)
├── pyproject.toml       # Project metadata & dependencies
├── LICENSE              # MIT License
└── .gitignore           # OS/Python ignore rules

インストール

1. リポジトリをクローンする

   git clone https://github.com/Muzain187/TG_MCP.git
   cd TG_MCP

2. 仮想環境の作成と有効化

   python3 -m venv venv
   source venv/bin/activate

3. 依存関係をインストールする

   pip install .

   mcp[cli]>=1.6.0およびpyTigerGraph>=1.8.6が必要です。

構成

実行する前に次の環境変数を設定します。

export TG_HOST=https://<your-tigergraph-host>
export TG_GRAPH=<your-graph-name>
export TG_SECRET=<your-api-secret>

これらはconfig.pyによって読み取られます。

クロードへの接続

この MCP サーバーをClaude デスクトップクライアントにインストールすると、Claude が TigerGraph ツールを直接呼び出すことができます。

uv run mcp install main.py

上記を実行した後、Claude Desktop を再起動すると、ハンマー 🛠 アイコンから MCP ツールが利用可能になります。

例:

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

   git checkout -b feature/YourFeature

3. 変更をコミットする

   git commit -m "Add YourFeature"

4. ブランチにプッシュ

   git push origin feature/YourFeature

5. プルリクエストを開く

すべての新しいコードがテストでカバーされ、PEP-8 スタイルに準拠していることを確認してください。

ライセンス

このプロジェクトはMIT ライセンスに基づいてライセンスされています。