TG_MCP
TigerGraph 操作 (クエリ、スキーマ、頂点、エッジ、UDF) を MCP エージェントの構造化ツールおよび URI ベースのリソースとして公開する軽量 Python インターフェイス。
目次
- 特徴
- プロジェクト構造
- インストール
- 構成
- クロードへの接続
- 例
- 貢献
- ライセンス
特徴
- スキーマイントロスペクション
完全なグラフ スキーマ (頂点とエッジの種類) を取得します。 - クエリ実行
インストールされた 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
インストール
- リポジトリをクローンする
git clone https://github.com/Muzain187/TG_MCP.git
cd TG_MCP
- 仮想環境の作成と有効化
python3 -m venv venv
source venv/bin/activate
- 依存関係をインストールする
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 ツールが利用可能になります。
例:
貢献
- リポジトリをフォークする
- 機能ブランチを作成する
git checkout -b feature/YourFeature
- 変更をコミットする
git commit -m "Add YourFeature"
- ブランチにプッシュ
git push origin feature/YourFeature
- プルリクエストを開く
すべての新しいコードがテストでカバーされ、PEP-8 スタイルに準拠していることを確認してください。
ライセンス
このプロジェクトはMIT ライセンスに基づいてライセンスされています。