by kuzudb
Provides LLMs with schema inspection and Cypher query execution capabilities for Kuzu databases via a Model Context Protocol server.
Enables large language models to retrieve the full schema of a Kuzu graph database and run Cypher queries against it. The server follows the Model Context Protocol, exposing tools and prompts that agents can call to interact with the underlying database.
config.json
(macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
, Windows: %APPDATA%\\Claude\\claude_desktop_config.json
).kuzu
entry under mcpServers
:{
"mcpServers": {
"kuzu": {
"command": "docker",
"args": [
"run",
"-v",
"{HOST_DIR}:/database",
"-e",
"KUZU_DB_FILE={DB_FILENAME}",
"--rm",
"-i",
"kuzudb/mcp-server"
]
}
}
}
Replace {HOST_DIR}
with the absolute path to the directory containing the database and {DB_FILENAME}
with the file name.
4. Restart Claude Desktop; the server will be available under the name kuzu
.
npm install
.kuzu
entry to config.json
:{
"mcpServers": {
"kuzu": {
"command": "node",
"args": [
"{ABS_PATH_TO_REPO}/index.js",
"{ABS_PATH_TO_DB_FILE}"
]
}
}
}
Set the environment variable KUZU_READ_ONLY=true
in the Docker or Node configuration to prevent any mutating queries.
kuzudb/mcp-server
for quick deployment.Q: Which environment variable points to the database file?
A: KUZU_DB_FILE
should contain the filename of the Kuzu database located in the mounted /database
directory.
Q: How do I enable read‑only mode?
A: Add -e "KUZU_READ_ONLY=true"
to the Docker args or set KUZU_READ_ONLY=true
in the Node environment.
Q: Can I run multiple Kuzu instances simultaneously?
A: Yes, define separate entries under mcpServers
with different names and distinct mount paths.
Q: What response format does the query
tool return?
A: Standard MCP JSON containing column names and row data, mirroring typical Cypher result sets.
Q: Do I need to build the Docker image myself?
A: No, the official image kuzudb/mcp-server
is published on Docker Hub and can be pulled automatically.
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.
getSchema
query
cypher
(string): The Cypher query to runquestion
(string): The question in natural language to generate the Cypher query forconfig.json
:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
mcpServers
object:
{
"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 pathnpm install
config.json
:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
mcpServers
object:
{
"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 pathsThe 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"
],
}
}
}
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "kuzu": { "command": "docker", "args": [ "run", "-v", "{HOST_DIR}:/database", "-e", "KUZU_DB_FILE={DB_FILENAME}", "--rm", "-i", "kuzudb/mcp-server" ], "env": {} } } }
Discover more MCP servers with similar functionality and use cases
by googleapis
Provides a configurable MCP server that abstracts connection pooling, authentication, observability, and tool management to accelerate development of database‑backed AI tools.
by bytebase
DBHub is a universal database gateway that implements the Model Context Protocol (MCP) server interface, enabling MCP-compatible clients to interact with various databases.
by neo4j-contrib
Provides Model Context Protocol servers for interacting with Neo4j databases, managing Aura instances, and handling personal knowledge graph memory through natural‑language interfaces.
by mongodb-js
Provides a Model Context Protocol server that connects to MongoDB databases and Atlas clusters, exposing a rich set of tools for querying, managing, and administering data and infrastructure.
by benborla
A Model Context Protocol (MCP) server that provides read-only access to MySQL databases, enabling Large Language Models (LLMs) to inspect database schemas and execute read-only queries.
by ClickHouse
Provides tools that let AI assistants run read‑only SQL queries against ClickHouse clusters or the embedded chDB engine, plus a health‑check endpoint for service monitoring.
by elastic
Provides direct, natural‑language access to Elasticsearch indices via the Model Context Protocol, allowing AI agents to query and explore data without writing DSL.
by motherduckdb
Provides an MCP server that enables SQL analytics on DuckDB and MotherDuck databases, allowing AI assistants and IDEs to execute queries via a unified interface.
by redis
Provides a natural language interface for agentic applications to manage and search data in Redis efficiently.