The Kuzu MCP server provides access to Kuzu databases for LLMs with the following capabilities:
- Fetch Schema: Retrieve the full schema of the Kuzu database, including all nodes, relationships tables, and their properties using the
getSchema
tool - Execute Queries: Run Cypher queries on the Kuzu database using the
query
tool - Generate Cypher Queries: Convert natural language questions into Cypher queries using the
generateKuzuCypher
prompt for more intuitive database interaction - Read-Only Mode: Operate in read-only mode to prevent database modifications by setting the
KUZU_READ_ONLY
environment variable - Deployment Options: Run using Docker (recommended) or Node.js (for development)
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
- on macOS:
- Add the following configuration to the
mcpServers
object: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
- on macOS:
- Add the following configuration to the
mcpServers
object: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:
local-only server
The server can only run on the client's local machine because it depends on local resources.
This server enables natural language interaction between a user and their Kuzu databases using clients like Claude Desktop or Cursor, allowing LLMs to retrieve the database schema, execute Cypher queries, create nodes, and establish relationships in the graph database.
Related MCP Servers
- AsecurityFlicenseAqualityThe server facilitates natural language interactions for exploring and understanding codebases, providing insights into data models and system architecture using a cost-effective, simple setup with support for existing Claude Pro subscriptions.Last updated -416Python
- -securityFlicense-qualityA server that enables interaction with PostgreSQL, MySQL, MariaDB, or SQLite databases through Claude Desktop using natural language queries.Last updated -Python
- -securityFlicense-qualityA protocol server that enables LLMs like Claude to interact with MongoDB databases, providing tools for schema exploration, aggregation queries, and data analysis through natural language in Cursor.Last updated -111TypeScript
- AsecurityAlicenseAqualityA server that enables LLMs like Claude to interact with Azure Cosmos DB databases through natural language queries, acting as a translator between AI assistants and database systems.Last updated -42JavaScriptMIT License