KuzuDB MCP Server provides LLM access to Kuzu graph databases through the Model Context Protocol. It enables AI assistants to inspect database schemas and execute Cypher queries with automatic connection recovery and built-in multi-agent coordination. Key features: - Execute Cypher queries against Kuzu graph databases with robust error handling and exponential backoff recovery - Schema inspection tools to discover nodes, relationships, and properties - Built-in web UI for database management including backup/restore and direct file upload - Multi-agent coordination with file-based locking for safe concurrent access - Authentication support via OAuth and Basic Auth - Natural language to Cypher query generation - Dual transport modes (stdio and HTTP) with Docker deployment options Note: This project is archived as of October 2025 following the archival of the upstream Kuzu database repository, but remains functional with Kuzu v1.4.1-r.4.

kuzudb-mcp-server

> ⚠️ ARCHIVED: This project is archived as the Kuzu database repository was archived on October 10, 2025. See ARCHIVE_NOTICE.md for details and alternatives.

---

A Model Context Protocol server that provides access to Kuzu graph databases. This server enables LLMs to inspect database schemas and execute queries with robust connection recovery, multi-agent coordination, and a built-in web interface.

Archive Status

Archived - October 21, 2025

The Kuzu graph database repository was archived by its maintainers on October 10, 2025 and is now read-only. As Kuzu is no longer actively maintained, this MCP server is also being archived. The project remains fully functional with Kuzu v1.4.1-r.4. See ARCHIVE_NOTICE.md for full details, technical achievements, and alternative graph database options.

🚀 Key Features

Quick Start

Install and Test

# Install globally
npm install -g kuzudb-mcp-server
Quick test with auto-created database
pnpm serve:test              # stdio transport (default)
pnpm serve:test:http         # HTTP transport with Web UI
pnpm serve:test:inspect      # HTTP with MCP Inspector
Server management
pnpm kill    # Stop running servers
pnpm restart # Restart with HTTP transport

Development Setup

# Clone and setup
git clone https://github.com/jordanburke/kuzudb-mcp-server.git
cd kuzudb-mcp-server
pnpm install
Initialize databases
pnpm db:init                 # Empty test database
pnpm db:init:movies          # Sample movie data

One-Line Docker Setup

# Pull and run with mounted database
docker run -d -p 3000:3000 -p 3001:3001 \
  -v /path/to/your/database:/database \
  ghcr.io/jordanburke/kuzudb-mcp-server:latest
Access Web UI at http://localhost:3001/admin
MCP endpoint at http://localhost:3000/mcp

Components

Tools

Prompts

🖥️ Web UI for Database Management

The server includes a powerful web interface that automatically starts with HTTP transport.

Features

Quick Access

# Start with Web UI (auto-enabled with HTTP)
pnpm serve:test:http
Access Web UI
open http://localhost:3001/admin

Docker with Web UI

# Using docker-compose (recommended)
docker-compose up -d
open http://localhost:3001/admin
Manual Docker with Web UI
docker run -d \
  -p 3000:3000 -p 3001:3001 \
  -v /path/to/database:/database \
  -e KUZU_WEB_UI_AUTH_USER=admin \
  -e KUZU_WEB_UI_AUTH_PASSWORD=changeme \
  ghcr.io/jordanburke/kuzudb-mcp-server:latest

API Endpoints

🔐 Authentication & Security

The server supports two authentication methods for different use cases:

OAuth (Production Recommended)

# Testing OAuth locally
pnpm serve:test:http:oauth     # admin/secret123
pnpm serve:test:inspect:oauth  # With MCP Inspector
Production OAuth setup
KUZU_OAUTH_ENABLED=true \
KUZU_OAUTH_USERNAME=admin \
KUZU_OAUTH_PASSWORD=your-secure-password \
KUZU_OAUTH_USER_ID=admin-user \
KUZU_OAUTH_EMAIL=admin@example.com \
KUZU_JWT_EXPIRES_IN=31536000 \
node dist/index.js /path/to/database --transport http

Basic Auth (Development/Testing)

```bash

Testing Basic Auth locally

Production Basic Auth setup