kuzu.com
kuzu.com logo

Kuzu

Bridge to Kuzu graph databases. Enables LLMs to inspect database schemas and execute queries.

Created byApr 23, 2025

kuzu-mcp-server

A Model Context Protocol server that provides access to Kuzu databases. This server enables LLMs to inspect database schemas and execute queries on provided kuzu database.

Components

Tools

  • getSchema - Fetch the full schema of the Kuzu database, including all nodes and relationships tables and their properties - Input: None
  • query - Run a Cypher query on the Kuzu database - Input: `cypher` (string): The Cypher query to run

Prompt

  • generateKuzuCypher - Generate a Cypher query for Kuzu - Argument: `question` (string): The question in natural language to generate the Cypher query for

Usage with Claude Desktop

With Docker (Recommended)

  • Edit the configuration file `config.json`: - on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - on Windows: `%APPDATA%\Claude\claude_desktop_config.json`
  • Add the following configuration to the `mcpServers` object: ```json { "mcpServers": { "kuzu": { "command": "docker", "args": [ "run", "-v", "{Absolute Path to the Kuzu database}:/database", "--rm", "-i", "kuzudb/mcp-server" ] } } } ``` Change the `{Absolute Path to the Kuzu database}` to the actual path
  • Restart Claude Desktop

With Node.js and npm (for Development)

  • Install dependencies: `npm install`
  • Edit the configuration file `config.json`: - on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - on Windows: `%APPDATA%\Claude\claude_desktop_config.json`
  • Add the following configuration to the `mcpServers` object: ```json { "mcpServers": { "kuzu": { "command": "node", "args": [ "{Absolute Path to this repository}/index.js", "{Absolute Path to the Kuzu database}", ] } } } ``` Change the `{Absolute Path to this repository}` and `{Absolute Path to the Kuzu database}` to the actual paths
  • Restart Claude Desktop

Read-Only Mode

The server can be run in read-only mode by setting the `KUZU_READ_ONLY` environment variable to `true`. In this mode, running any query that attempts to modify the database will result in an error. This flag can be set in the configuration file as follows: