Kuzu
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
What is Kuzu?
Kuzu is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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 quer...
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
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This server enables natural language interaction between a u
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx kuzu-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Kuzu
Kuzu MCP Server enables natural language interaction with Kuzu embedded graph databases by connecting AI assistants to your Kuzu database through the Model Context Protocol. It exposes tools to retrieve the full database schema, execute Cypher queries, create nodes, and establish relationships, allowing users to explore and manipulate graph data without writing Cypher manually. Data scientists, developers, and analysts working with knowledge graphs, social networks, or any property graph data can use it to interrogate their Kuzu databases conversationally through clients like Claude Desktop or Cursor.
Prerequisites
- A Kuzu database file on your local filesystem
- Docker installed (recommended installation method) or Node.js 18+ for the npm-based method
- Claude Desktop or another MCP-compatible client
- Basic familiarity with Cypher query language is helpful but not required
Prepare your Kuzu database
Ensure you have a Kuzu database file ready. If you don't have one yet, you can create an empty database with the Kuzu CLI or Python library, or download a sample dataset from the Kuzu documentation.
# Example: create a database with the Kuzu Python library
pip install kuzu
python -c "import kuzu; db = kuzu.Database('/path/to/mydb'); print('DB created')" Configure Claude Desktop with Docker (recommended)
Add the Kuzu MCP server to your Claude Desktop config using Docker. Replace /path/to/mydb with the directory containing your database and mydb with the database filename.
{
"mcpServers": {
"kuzu": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-v", "/path/to/mydb:/database",
"-e", "KUZU_DB_FILE=mydb",
"kuzudb/kuzu-mcp-server"
]
}
}
}Configure Claude Desktop with Node.js (alternative)
Alternatively, run the server using npx without Docker. Provide the absolute path to your database file via the KUZU_DB_FILE environment variable.
{
"mcpServers": {
"kuzu": {
"command": "npx",
"args": ["kuzu-mcp-server"],
"env": {
"KUZU_DB_FILE": "/absolute/path/to/mydb"
}
}
}
}Enable read-only mode (optional)
If you want to prevent any database modifications and only allow read queries, set the KUZU_READ_ONLY environment variable to true.
{
"mcpServers": {
"kuzu": {
"command": "npx",
"args": ["kuzu-mcp-server"],
"env": {
"KUZU_DB_FILE": "/absolute/path/to/mydb",
"KUZU_READ_ONLY": "true"
}
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop to load the Kuzu server. Ask Claude to fetch the database schema to confirm the connection is working.
Kuzu Examples
Client configuration
Claude Desktop configuration using npx to connect to a local Kuzu database file in read-only mode.
{
"mcpServers": {
"kuzu": {
"command": "npx",
"args": ["kuzu-mcp-server"],
"env": {
"KUZU_DB_FILE": "/Users/yourname/data/mygraphdb",
"KUZU_READ_ONLY": "false"
}
}
}
}Prompts to try
Natural language prompts for exploring and querying a Kuzu graph database.
- "What is the schema of my Kuzu database? Show me all node and relationship types."
- "Find all Person nodes and return their names and ages"
- "Create a new Person node with name 'Alice' and age 30"
- "Show me all relationships between Person and Company nodes"
- "Find the shortest path between Person 'Alice' and Person 'Bob'"
- "How many nodes of each type are in the database?"Troubleshooting Kuzu
Server fails to start with 'database not found' error
KUZU_DB_FILE must be the exact filename of the database (not the directory path). When using Docker, mount the parent directory with -v and set KUZU_DB_FILE to just the filename. When using npx, provide the full absolute path to the database file.
Write queries fail with a read-only error
Check if KUZU_READ_ONLY is set to 'true' in your environment. Set it to 'false' or remove the variable entirely to allow write operations. Also ensure the process has write permissions on the database file path.
Cypher query syntax errors when the AI generates queries
Use the generateKuzuCypher prompt tool by asking the AI to 'generate a Kuzu Cypher query for [your question]' before executing — this triggers a prompt that converts natural language to validated Kuzu-compatible Cypher before running it.
Frequently Asked Questions about Kuzu
What is Kuzu?
Kuzu is a Model Context Protocol (MCP) server that 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 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Kuzu?
Follow the installation instructions on the Kuzu GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Kuzu?
Kuzu works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Kuzu free to use?
Yes, Kuzu is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Kuzu Alternatives — Similar Databases Servers
Looking for alternatives to Kuzu? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Kuzu in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Kuzu?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.