GraphDB MCP サーバー

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

コンポーネント

ツール

スパーククエリ
- 接続されたGraphDBリポジトリに対してSPARQLクエリを実行する
- 入力：
  - query (文字列): 実行するSPARQLクエリ
  - graph (文字列、オプション): 対象となる特定のグラフ IRI
  - format （文字列、オプション）：レスポンス形式（json、xml、csv）
- すべてのクエリは読み取り専用モードで実行されます
リストグラフ
- リポジトリで利用可能なすべてのグラフを一覧表示します
- 入力パラメータは不要

リソース

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

クラスリスト( 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 アプリで使用するには、 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"
      }
    }
  }
}

値を特定の GraphDB 構成に置き換えます。

インストール

# Clone the repository
git clone https://github.com/yourname/mcp-server-graphdb.git
cd mcp-server-graphdb

# Install dependencies
yarn install

# Build the project
yarn build

SPARQLクエリの例

このサーバーで実行できる SPARQL クエリの例を次に示します。

オントロジー内のすべてのクラスを一覧表示します。

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
SELECT DISTINCT ?class ?label
WHERE {
  { ?class a rdfs:Class } UNION { ?class a owl:Class }
  OPTIONAL { ?class rdfs:label ?label }
}
ORDER BY ?class

特定のクラスのすべてのプロパティを一覧表示します。

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
SELECT ?property ?label ?range
WHERE {
  ?property rdfs:domain <http://example.org/YourClass> .
  OPTIONAL { ?property rdfs:label ?label }
  OPTIONAL { ?property rdfs:range ?range }
}
ORDER BY ?property

クラス別にインスタンスをカウントします。

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
SELECT ?class (COUNT(?instance) AS ?count)
WHERE {
  ?instance a ?class
}
GROUP BY ?class
ORDER BY DESC(?count)

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。