kuzu

The kuzu MCP server provides a bridge to a Kuzu database, exposing tools that let large language models inspect the database schema and execute Cypher queries. It exposes two core tools: getSchema, which fetches the full schema of the Kuzu database including nodes, relationships, and their properties; and query, which executes a Cypher query against the configured Kuzu database. There's also a prompt capability, generateKuzuCypher, which can translate natural language questions into Cypher queries suitable for Kuzu. In deployment via Docker, you run the server in a container that maps your local Kuzu database into the container, and you can toggle read-only mode by setting KUZU_READ_ONLY to true. When using Claude Desktop or similar MCP clients, add an entry under mcpServers named kuz u with the docker command configuration described in the README to enable quick access to the database through the MCP interface.

Prerequisites:

• Docker installed and running on your machine.
• Access to a Kuzu database file (.db) that you want to expose through MCP.

Installation steps (Docker, recommended):

1. Ensure your Kuzu database file is accessible on host, for example at /path/to/your/database.db.
2. Run the MCP server container with the Kuzu database mounted:

docker run -v /path/to/your/database:/database -e KUZU_DB_FILE=database.db --rm -i kuzudb/mcp-server

3. If you want read-only mode (recommended for safe querying in some environments), set KUZU_READ_ONLY=true:

docker run -v /path/to/your/database:/database -e KUZU_DB_FILE=database.db -e KUZU_READ_ONLY=true --rm -i kuzudb/mcp-server

4. If you are configuring Claude Desktop or another MCP client, add the server under mcpServers with the configuration shown in the README, pointing to the docker invocation above.

Tips and common issues:

• Ensure the KUZU_DB_FILE environment variable matches the filename of your Kuzu database inside the mounted /database path.
• In read-only mode, any query attempting to modify data will error; this is useful for safe exploration.
• If you encounter connection issues, verify Docker can access the mounted directory and that the database file is not locked by another process.
• When using Node.js development setup, the README also provides a path-based approach to launching the server directly from source; however, the primary distribution here uses Docker for portability.
• If you switch between environments (macOS, Windows), ensure the Claude Desktop config.json path is updated accordingly as described in the instructions.