Puppygraph MCP Server

🚀 Graph MCP サーバー

PuppyGraph 用のモデルコンテキストプロトコル (MCP) サービスを提供するサーバーです。Claude Desktop を通じて、Claude が Gremlin と Cypher を使用してグラフデータベースをクエリできるようにします。

🚀 クイックスタート

このサーバーは、PuppyGraph 用の MCP サービスを提供し、Claude が Gremlin と Cypher を使用してグラフデータベースをクエリできるようにします。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• Neo4j Bolt プロトコル（Cypher 用）と WebSocket（Gremlin 用）を使用して、複数の PuppyGraph インスタンスに接続します。
• Gremlin と Cypher のクエリ言語を使用して、グラフデータをクエリします。
• 複数のエンドポイントからグラフ構造とスキーマ情報を取得します。
• 接続状態を検証するためのツールを備えています。

📦 インストール

# すべての依存関係をインストールする
npm install

# 開発サーバーを起動する
npm start

# 本番環境用のバージョンをビルドする
npm run build

💻 使用例

基本的な使用法

プロジェクト構造

puppy-graph-mcp/
├── src/                 # ソースコードディレクトリ
│   ├── main.ts         # メインプログラムのエントリーポイント
│   └── services/       # 外部サービスインターフェイスの実装
├── tests/              # テストケース
└── package.json        # プロジェクトの依存関係とスクリプト

設定説明

• 環境変数

ツールの使用

# 接続状態を確認する
puppygraph status

# Cypher クエリを実行する
puppygraph query --cypher "MATCH (n) RETURN count(n)"

# Gremlin クエリを実行する
puppygraph gremlin g.V().count()

高度な使用法

接続条件

1. ターゲットサーバーが実行中で、ネットワーク経由でアクセス可能であることを確認します。
2. ファイアウォール規則が対応するポートの通信を許可していることを検証します。
3. 提供された認証資格情報が正しいことを確認します。

🔧 技術詳細

• モジュール化アーキテクチャ：コードは機能別にモジュールに分割されており、保守と拡張が容易です。
• 非同期通信：async/await を使用して非ブロッキング操作を実装しています。
• エラー処理：詳細なエラーログとリトライメカニズムを提供します。
• 拡張性：プラグイン拡張をサポートし、より多くの機能を追加できます。

📄 ライセンス

Apache 2.0