Kuzu

Kuzu

MCP server enabling schema inspection and query execution on Kuzu databases.

38
Stars
29
Forks
0
Releases

Overview

kuzu-mcp-server is a Model Context Protocol server that provides access to Kuzu graph databases. It exposes two core tools: getSchema, which fetches the full schema of the Kuzu database, including all nodes and relationships tables and their properties, and query, which executes Cypher queries against the provided Kuzu database. A prompt tool, generateKuzuCypher, can transform natural language questions into Cypher queries for Kuzu. This setup enables LLMs to understand and explore the database structure and perform data retrieval or manipulation through controlled, executable queries. The server supports deployment via Docker (recommended) or Node.js for development. Claude Desktop users can configure the MCP server by editing a Claude config.json (config.json) and adding an mcpServers entry for kuzudb/mcp-server (or by pointing Node.js at index.js with the path to the Kuzu DB file). A read-only mode is available by setting KUZU_READ_ONLY=true, which prevents write operations. The README provides concrete config examples for Docker and Node.js deployments, including how to mount the Kuzu database and specify the DB file name. This MCP server is designed for AI-assisted database exploration and querying with clear safety controls.

Details

Owner
kuzudb
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

getSchema

Fetch the full Kuzu database schema, including all nodes, relationships, and properties.

query

Run a Cypher query on the Kuzu database.

generateKuzuCypher

Generate a Cypher query for Kuzu from a natural language question.

Read-only mode

Enable KUZU_READ_ONLY to block write operations and prevent modifications.

Docker deployment

Run the MCP server with Docker, mounting the database and configuring KUZU_DB_FILE.

Node.js development deployment

Run index.js with the Kuzu DB path for development and testing.

Claude Desktop integration

Configure via Claude Desktop config.json to register the kuzudb/mcp-server MCP.

Audience

LLM developersEnable LLMs to inspect Kuzu DB schemas and execute queries via the MCP server.
Claude Desktop usersIntegrate with Claude Desktop to manage Kuzu MCP server configuration and run queries.
DevelopersBuild AI tools to inspect Kuzu DB schemas and execute MCP queries.

Tags

KuzuMCPdatabaseschemaCypherLLMClaude DesktopDockerNode.jsread-only