Kuzu MCP Server

🚀 kuzu-mcp-server

このサーバーは、Kuzuデータベースへのアクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバーです。大規模言語モデルがKuzuデータベースのスキーマをinspect（検査）し、クエリを実行できるようにします。

✨ 主な機能

ツール

• getSchema

  • Kuzuデータベースの完全なスキーマ（すべてのノードとリレーションシップテーブルおよびその属性）を取得します。
  • 入力：なし

• query

  • Kuzuデータベース上でCypherクエリを実行します。
  • 入力：cypher（文字列）：実行するCypherクエリ

プロンプト

• generateKuzuCypher
  • 自然言語の質問からKuzuのCypherクエリを生成します。
  • パラメータ：question（文字列）：Cypherクエリを生成するための自然言語の質問

📦 インストール

Claude Desktopでの使用方法

Dockerを使用する場合（推奨）

• 設定ファイル config.json を編集します。

  • macOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windowsの場合：%APPDATA%\Claude\claude_desktop_config.json%

• 以下の設定を mcpServers オブジェクトに追加します。

{
    "mcpServers": {
        "kuzu": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "{Absolute Path to the Kuzu database}:/database",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ]
        }
    }
}

{Absolute Path to the Kuzu database} を実際のパスに置き換えます。

• Claude Desktopを再起動します。

Node.jsとnpmを使用する場合（開発用）

• 依存関係をインストールします：npm install

• 設定ファイル config.json を編集します。

  • macOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windowsの場合：%APPDATA%\Claude\claude_desktop_config.json%

• 以下の設定を mcpServers オブジェクトに追加します。

{
    "mcpServers": {
        "kuzu": {
            "command": "node",
            "args": [
                "{Absolute Path to this repository}/index.js",
                "{Absolute Path to the Kuzu database}"
            ]
        }
    }
}

{Absolute Path to this repository} と {Absolute Path to the Kuzu database} を実際のパスに置き換えます。

• Claude Desktopを再起動します。

読み取り専用モード

KUZU_READ_ONLY 環境変数を true に設定することで、サーバーを読み取り専用モードで実行できます。このモードでは、データベースを変更しようとするクエリを実行するとエラーが発生します。このフラグは、設定ファイルで以下のように設定できます。

{
    "mcpServers": {
        "kuzu": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "{Absolute Path to the Kuzu database}:/database",
                "-e",
                "KUZU_READ_ONLY=true",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ]
        }
    }
}