Kuzu

You get a Model Context Protocol (MCP) server that exposes a Kuzu database so you can inspect schemas and execute queries from your LLM workflows. This server lets you fetch the full database schema and run Cypher queries, enabling seamless data access for natural language to database interactions.

How to use

You connect to the Kuzu MCP Server through an MCP client. Use the getSchema tool to fetch the complete schema of your Kuzu database, including all nodes and relationships and their properties. Use the query tool to run Cypher queries against the Kuzu database. The generateKuzuCypher prompt helps you translate natural language questions into Cypher queries for Kuzu.

How to install

Prerequisites you need before starting: Docker (for the Docker-based approach) and/or Node.js with npm (for local development). Ensure you have access to the Kuzu database file you want to expose via MCP.

Docker-based setup steps

1) Install Docker on your system if it is not already installed.
2) Edit your Claude Desktop MCP configuration to add a Kuzu server entry under mcpServers.
3) Use the following settings to start the server inside Docker, pointing to your Kuzu database file:

{
  "mcpServers": {
    "kuzu": {
      "command": "docker",
      "args": [
        "run",
        "-v",
        "{Path to the directory containing Kuzu database file}:/database",
        "-e",
        "KUZU_DB_FILE={Kuzu database file name}",
        "--rm",
        "-i",
        "kuzudb/mcp-server"
      ]
    }
  }
}

Replace {Path to the directory containing Kuzu database file} with your actual directory path and {Kuzu database file name} with your database file name. Restart Claude Desktop after saving the config.

Node.js and npm-based development setup steps

1) Ensure Node.js and npm are installed.
2) Install dependencies for the MCP server repository:
   npm install
3) Edit your Claude Desktop MCP configuration to add a Kuzu server entry under mcpServers.
4) Use the following settings to run the MCP server locally, pointing to the Kuzu database file:

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

Replace {Absolute Path to this repository} with the actual path to the MCP server code, and {Absolute Path to the Kuzu database file} with the actual path to your database file. Restart Claude Desktop after saving the config.

Read-Only Mode: safeguard the database by preventing any write operations. To enable, set the KUZU_READ_ONLY environment variable to true in the Docker or Node run configuration. When enabled, queries attempting to modify the database will error.

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

Additional notes and tips

The MCP server exposes a straightforward set of tools you can use from your MCP client: getSchema to retrieve the full schema and query to run Cypher queries. A helper prompt generateKuzuCypher can convert natural language questions into Cypher queries compatible with Kuzu.

Tools you can invoke in your workflow:

• getSchema: Fetches the full schema of the Kuzu database, including nodes, relationships, and properties.
• query: Executes a Cypher query against the Kuzu database.
• generateKuzuCypher: Generates a Cypher query from a natural language question.

Available tools

getSchema

Fetches the full schema of the Kuzu database, including all nodes and relationships tables and their properties

query

Run a Cypher query on the Kuzu database

generateKuzuCypher

Generate a Cypher query for Kuzu from a natural language question