Dgraph MCP Server

🚀 Dgraph MCP サーバー

mcp-go ライブラリを使用して実装された、Dgraph グラフデータベースのモデルコンテキストプロトコル（MCP）サーバーです。

このプロジェクトは、Dgraph データベースとのやり取りを行う MCP サーバーを実現し、大規模言語モデル（LLM）アプリケーションが以下の操作を実行できるようにします。

• DQL クエリの実行
• ミューテーション操作の実行
• スキーマの変更
• 現在のスキーマの取得

🚀 クイックスタート

このサーバーは、MCP プロトコルをサポートする任意の LLM フレームワークと統合でき、標準入出力を介して通信するため、様々な LLM ツールフレームワークとの統合が容易です。

✨ 主な機能

• DQL クエリの実行
• ミューテーション操作の実行
• スキーマの変更
• 現在のスキーマの取得

📦 インストール

前提条件

• Go 1.18 以上のバージョン
• 稼働中の Dgraph データベース（ローカルまたはリモート）

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

go mod download

🔧 設定

サーバーは環境変数を使用して設定できます。

• DGRAPH_HOST：Dgraph サービスのアドレス（デフォルト：localhost:9080）

💻 使用例

サーバーの起動

go run main.go

このサーバーは、標準入出力を使用して LLM アプリケーションと通信します。

利用可能なツール

1. dgraph_query

Dgraph に対して DQL クエリを実行します。

• パラメータ:
  • query（文字列、必須）：実行する DQL クエリ
  • variables（オブジェクト、オプション）：クエリ内の変数
• 例:

{
  "tool": "dgraph_query",
  "params": {
    "query": "{ me(func: has(name)) { name } }"
  }
}

2. dgraph_mutate

Dgraph に対してミューテーション操作を実行します。

• パラメータ:
  • mutation（文字列、必須）：実行する RDF ミューテーション
  • commit（ブール値、オプション）：トランザクションをコミットするかどうか（デフォルト：true）
• 例:

{
  "tool": "dgraph_mutate",
  "params": {
    "mutation": "_:person <name> \"John Doe\" .",
    "commit": true
  }
}

3. dgraph_alter_schema

Dgraph のスキーマを変更します。

• パラメータ:
  • schema（文字列、必須）：適用するスキーマ定義
• 例:

{
  "tool": "dgraph_alter_schema",
  "params": {
    "schema": "name: string @index(exact) ."
  }
}

利用可能なリソース

1. dgraph://schema

現在の Dgraph スキーマを返します。

クエリ例

基本的なクエリ

{
  people(func: has(name)) {
    name
    age
    friends {
      name
    }
  }
}

データの追加

_:alice <name> "Alice" .
_:alice <age> "30" .
_:bob <name> "Bob" .
_:bob <age> "32" .
_:alice <friend> _:bob .

スキーマ定義

name: string @index(exact) .
age: int .
friend: [uid] .

📄 ライセンス

MIT