Kuzu MCP server
OfficialThe 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
getSchematoolExecute Queries: Run Cypher queries on the Kuzu database using the
querytoolGenerate Cypher Queries: Convert natural language questions into Cypher queries using the
generateKuzuCypherprompt for more intuitive database interactionRead-Only Mode: Operate in read-only mode to prevent database modifications by setting the
KUZU_READ_ONLYenvironment variableDeployment Options: Run using Docker (recommended) or Node.js (for development)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kuzu MCP server show me all the people who work in the engineering department"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: MCP-Python
Usage with Claude Desktop
With Docker (Recommended)
Edit the configuration file
config.json:on macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonon Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the following configuration to the
mcpServersobject:{ "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" ] } } }Change the
{Path to the directory containing Kuzu database file}to the actual pathRestart Claude Desktop
With Node.js and npm (for Development)
Install dependencies:
npm installEdit the configuration file
config.json:on macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonon Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the following configuration to the
mcpServersobject:{ "mcpServers": { "kuzu": { "command": "node", "args": [ "{Absolute Path to this repository}/index.js", "{Absolute Path to the Kuzu database file}", ] } } }Change the
{Absolute Path to this repository}and{Absolute Path to the Kuzu database file}to the actual pathsRestart 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:
{
"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"
],
}
}
}Available Tools
2 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: getSchema retrieves database structure metadata, while query executes data retrieval/manipulation operations. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.
Both tools follow a consistent verb_noun naming pattern (getSchema, query). While 'query' is a noun rather than verb_noun, it's a standard database term that pairs naturally with 'getSchema', maintaining clear and predictable naming throughout the minimal toolset.
With only 2 tools, this server feels severely under-scoped for a database interface. A typical database MCP server would include tools for data manipulation (insert, update, delete), transaction management, connection handling, or at least parameterized queries beyond just raw query execution.
For a database server, the surface is significantly incomplete. While getSchema and query provide read capabilities, there are no tools for data modification (insert/update/delete), transaction control, connection management, or even parameterized query execution. This creates dead ends for agents needing to perform basic database operations.
Related MCP Connectors
Text-to-SQL MCP server: read-only queries on PostgreSQL, MySQL and SQL Server with your real schema
A collaborative substrate over your data: vector, knowledge graph, SQL, geospatial, streaming.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis server enables interaction between Neo4j databases and Claude Desktop, allowing users to execute Cypher queries, create nodes, and establish relationships in the database.3184 npm59MIT
- FlicenseNot gradedqualityDmaintenanceA server that enables interaction with PostgreSQL, MySQL, MariaDB, or SQLite databases through Claude Desktop using natural language queries.1-
- AlicenseCqualityBmaintenanceA server that enables LLMs (like Claude and VSCode Copilot) to interact with Azure Cosmos DB data through natural language queries, acting as a translator between AI assistants and your database.331 npm3MIT
- AlicenseNot gradedqualityFmaintenanceA 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.19 npm8MIT