GraphDB MCP Server

GraphDB MCP サーバー

概要

データベースとのやり取りを可能にし、GraphDB を通じてグラフを探索する機能を提供する Model Context Protocol（MCP）サーバーの実装です。 このサーバーでは、SPARQL グラフクエリを実行できます。

コンポーネント

ツール

サーバーでは、以下の主要なツールを利用できます。

• read-graphdb-sparql

  • リポジトリからデータを読み取るための SPARQL 読み取りクエリを実行します
  • 入力：
    • query（文字列）：実行する SPARQL クエリ
  • 戻り値：オブジェクトの配列として JSON 形式にシリアライズされたクエリ結果

• get-graphdb-schema

  • GraphDB データベースのオントロジーを定義する RDF トリプルの一覧を取得します
  • 入力は不要です
  • 戻り値：GraphDB データベースのオントロジーを定義する RDF トリプルの一覧を JSON 形式でシリアライズしたもの

Claude Desktop での使用方法

"mcpServers": {
    "mcp-graphdb": {
        "command": "uvx",
        "args": [
            "D:\\Source\\mcp\\mcp-graphdb",
            "--db-url",
            "http://localhost:7200/repositories/starwars",
            "--schema-file",
            "D:\\Source\\mcp\\mcp-graphdb\\data\\starwars-ontology.trig",
            "--username",
            "ignore",
            "--password",
            "ignore"
        ]
    }
}

開発

前提条件

1. uv（Universal Virtualenv）をインストールします。

# Using pip
pip install uv

# Using Homebrew on macOS
brew install uv

# Using cargo (Rust package manager)
cargo install uv

2. リポジトリをクローンし、開発環境をセットアップします。

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

# Create and activate virtual environment using uv
uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install dependencies
uv pip install -e .

開発設定

# Add the server to your claude_desktop_config.json
"mcpServers": {
    "mcp-graphdb": {
        "command": "uvx",
        "args": [
            "D:\\Source\\mcp\\mcp-graphdb",
            "--db-url",
            "http://localhost:7200/repositories/starwars",
            "--schema-file",
            "D:\\Source\\mcp\\mcp-graphdb\\data\\starwars-ontology.trig",
            "--username",
            "ignore",
            "--password",
            "ignore"
        ]
    }
}

データ

このプロジェクトでは、改変した Star Wars オントロジーといくつかのインスタンスデータを使用しています。元のデータは Nick Drummand によって管理されています。

https://nickdrummond.github.io/star-wars-ontology/

ブログ記事

この MCP サーバーの作成と使用に関する経験をまとめたブログ記事を公開しました。

https://medium.com/@ianormy/mcp-for-graphdb-d3d3cd00cd4e

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。