MCP Graphdb

🚀 グラフデータベース MCP サーバー

このサーバーは、Ontotext GraphDB への読み取り専用アクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバーです。大規模言語モデル（LLMs）が RDF グラフを探索し、GraphDB インスタンスに対して SPARQL クエリを実行できるようになります。

✨ 主な機能

ツール

• sparqlQuery

  • 接続された GraphDB リポジトリに対して SPARQL クエリを実行します。
  • 入力パラメータ：
    • query（文字列）：実行する SPARQL クエリ
    • graph（文字列、オプション）：指定するターゲットグラフの IRI
    • format（文字列、オプション）：応答形式（json、xml、csv）
  • すべてのクエリは読み取り専用モードで実行されます。

• listGraphs

  • リポジトリ内のすべての利用可能なグラフをリストします。
  • 入力パラメータは不要です。

リソース

このサーバーは、リポジトリデータの複数のビューを提供します。

• クラスリスト（graphdb://<host>/repository/<repo>/classes）
  • リポジトリ内のすべての RDF クラスとそのカウントをリストします。
• 述語（graphdb://<host>/repository/<repo>/predicates）
  • すべての述語（属性）とその使用回数をリストします。
• 統計情報（graphdb://<host>/repository/<repo>/stats）
  • 主語、述語、目的語、およびトリプルのカウントを提供します。
• サンプルデータ（graphdb://<host>/repository/<repo>/sample）
  • リポジトリ内のトリプルのサンプルを表示します。
• グラフ内容（graphdb://<host>/repository/<repo>/graph/<graphUri>）
  • 特定のグラフとそのメタデータのサンプルデータを提供します。

📦 インストール

環境変数による設定

.env ファイルを作成し、以下の内容を記述します。

GRAPHDB_ENDPOINT=http://localhost:7200
GRAPHDB_REPOSITORY=myRepository
GRAPHDB_USERNAME=username
GRAPHDB_PASSWORD=password

コマンドライン引数による設定

以下のコマンドを実行します。

node dist/index.js http://localhost:7200 myRepository

コマンドライン引数は環境変数よりも優先されます。

🚀 クイックスタート

クロードデスクトップとの連携

Claude Desktop アプリでこのサーバーを使用するには、claude_desktop_config.json の "mcpServers" セクションに以下の設定を追加します。

{
  "mcpServers": {
    "graphdb": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-graphdb/dist/index.js"
      ],
      "env": {
        "GRAPHDB_ENDPOINT": "http://localhost:7200",
        "GRAPHDB_REPOSITORY": "myRepository",
        "GRAPHDB_USERNAME": "username",
        "GRAPHDB_PASSWORD": "password"
      }
    }
  }
}

インストール手順

1. サーバーコードをターゲットディレクトリにダウンロードします。
2. ターミナルで以下のインストールコマンドを実行します。

   npm install
   

3. サーバーを起動します。

   node dist/index.js <GraphDB Endpoint> <Repository Name>
   

💻 使用例

基本的な使用法

例 1: 基本的な SPARQL クエリ

SELECT * WHERE { ?subject ?predicate ?object }

例 2: すべてのグラフをリストする

以下のコマンドを実行します。

./listGraphs.sh

📄 ライセンス

このプロジェクトは Apache 2.0 ライセンスに従います。