kuzu-mcp-server

Kuzuデータベースへのアクセスを提供するモデルコンテキストプロトコルサーバー。このサーバーにより、LLMはデータベーススキーマを検査し、提供されたKuzuデータベースに対してクエリを実行できます。

コンポーネント

ツール

• スキーマ取得

  • すべてのノードと関係テーブルとそのプロパティを含む、Kuzu データベースの完全なスキーマを取得します。

  • 入力: なし

• クエリ

  • KuzuデータベースでCypherクエリを実行する

  • 入力: cypher (文字列): 実行するCypherクエリ

プロンプト

• クズサイファーを生成する

  • KuzuのCypherクエリを生成する

  • 引数: question (文字列): Cypherクエリを生成するための自然言語の質問

Related MCP server: MCP-Python

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デスクトップを再起動します

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デスクトップを再起動します

読み取り専用モード

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"
            ],
        }
    }
}