Skip to main content
Glama
deenesjakoruzh
kuzudb

Kuzu MCP server

Official
by kuzudb
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Kuzu-MCP-Server

Ein Model Context Protocol-Server, der Zugriff auf Kuzu-Datenbanken bietet. Dieser Server ermöglicht LLMs die Überprüfung von Datenbankschemata und die Ausführung von Abfragen in der bereitgestellten Kuzu-Datenbank.

Komponenten

Werkzeuge

  • getSchema

    • Holen Sie sich das vollständige Schema der Kuzu-Datenbank, einschließlich aller Knoten- und Beziehungstabellen und ihrer Eigenschaften

    • Eingabe: Keine

  • Abfrage

    • Führen Sie eine Cypher-Abfrage in der Kuzu-Datenbank aus

    • Eingabe: cypher (Zeichenfolge): Die auszuführende Cypher-Abfrage

Prompt

  • KuzuCypher generieren

    • Generieren Sie eine Cypher-Abfrage für Kuzu

    • Argument: question (Zeichenfolge): Die Frage in natürlicher Sprache, für die die Cypher-Abfrage generiert werden soll

Related MCP server: MCP-Python

Verwendung mit Claude Desktop

Mit Docker (empfohlen)

  • Bearbeiten Sie die Konfigurationsdatei config.json :

    • unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • unter Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Fügen Sie dem mcpServers -Objekt die folgende Konfiguration hinzu:

    {
  "mcpServers": {
      "kuzu": {
          "command": "docker",
          "args": [
              "run",
              "-v",
              "{Absolute Path to the Kuzu database}:/database",
              "--rm",
              "-i",
              "kuzudb/mcp-server"
          ]
      }
  }
}

    Ändern Sie den {Absolute Path to the Kuzu database} in den tatsächlichen Pfad

  • Starten Sie Claude Desktop neu

Mit Node.js und npm (für die Entwicklung)

  • Abhängigkeiten installieren: npm install

  • Bearbeiten Sie die Konfigurationsdatei config.json :

    • unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • unter Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Fügen Sie dem mcpServers -Objekt die folgende Konfiguration hinzu:

    {
  "mcpServers": {
      "kuzu": {
          "command": "node",
          "args": [
              "{Absolute Path to this repository}/index.js",
              "{Absolute Path to the Kuzu database}",
          ]
      }
  }
}

    Ändern Sie den {Absolute Path to this repository} und {Absolute Path to the Kuzu database} in die tatsächlichen Pfade

  • Starten Sie Claude Desktop neu

Schreibgeschützter Modus

Der Server kann im schreibgeschützten Modus ausgeführt werden, indem die Umgebungsvariable KUZU_READ_ONLY auf true gesetzt wird. In diesem Modus führt jede Abfrage, die versucht, die Datenbank zu ändern, zu einem Fehler. Dieses Flag kann in der Konfigurationsdatei wie folgt gesetzt werden:

{
    "mcpServers": {
        "kuzu": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "{Absolute Path to the Kuzu database}:/database",
                "-e",
                "KUZU_READ_ONLY=true",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ],
        }
    }
}

Available Tools

2 tools
getSchemaB

Get the schema of the Kuzu database

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states what the tool does but doesn't describe how it behaves—e.g., whether it returns a full schema, requires permissions, has side effects, or handles errors. This leaves significant gaps for a tool that interacts with a database.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence with no wasted words, clearly front-loading the core purpose. It's appropriately sized for a simple tool with no parameters, making it highly efficient and easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (simple, no parameters) and lack of annotations and output schema, the description is minimally adequate but incomplete. It states what the tool does but doesn't cover behavioral aspects like return format or error handling, which are important for a database tool, leaving room for improvement.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, and the input schema has 100% description coverage (though empty). The description doesn't need to compensate for missing parameter info, so it meets the baseline of 4 for tools with no parameters, as it doesn't mislead about inputs.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and the resource ('schema of the Kuzu database'), making the purpose understandable. However, it doesn't differentiate from its sibling tool 'query' (which likely executes queries rather than retrieving metadata), so it doesn't reach the highest score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like the 'query' sibling tool. It lacks context about scenarios where retrieving the schema is appropriate, such as for database exploration or query planning, leaving usage entirely implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

queryC

Run a Cypher query on the Kuzu database

ParametersJSON Schema
NameRequiredDescriptionDefault
cypherNoThe Cypher query to run

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure but only states the basic function. It doesn't mention whether this is a read-only or write operation, what permissions are required, potential side effects, error handling, or any limitations like query complexity or timeout constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise - a single sentence that directly states the tool's purpose with zero wasted words. It's front-loaded with the essential information and contains no unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a database query tool with no annotations and no output schema, the description is insufficient. It doesn't explain what kind of results to expect, error conditions, or the fact that this appears to be a general-purpose query tool versus the schema-specific sibling. The agent lacks crucial context for proper tool selection and invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the single 'cypher' parameter. The description doesn't add any additional meaning about parameter usage beyond what the schema provides, maintaining the baseline score for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Run a Cypher query') and target resource ('on the Kuzu database'), providing specific verb+resource pairing. However, it doesn't differentiate from the sibling tool 'getSchema' - both could involve querying but for different purposes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus the sibling 'getSchema' tool, nor any context about appropriate use cases. The description simply states what the tool does without indicating when it should be selected over alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.0.0
    • First observedgetSchema
    • First observedquery
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.1/5.0

Scored across 2 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness2/5

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.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Neo4j Server

    da-okazaki
    A
    license
    B
    quality
    D
    maintenance
    This server enables interaction between Neo4j databases and Claude Desktop, allowing users to execute Cypher queries, create nodes, and establish relationships in the database.
    3
    111 npm
    59
    MIT

  • MCP-Python

    rhabraken
    F
    license
    Not graded
    quality
    D
    maintenance
    A server that enables interaction with PostgreSQL, MySQL, MariaDB, or SQLite databases through Claude Desktop using natural language queries.
    1
    -

  • PlayFab MCP Server

    akiojin
    A
    license
    C
    quality
    A
    maintenance
    A 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.
    3
    22 npm
    3
    MIT

  • kuzudb-mcp-server

    jordanburke
    A
    license
    Not graded
    quality
    F
    maintenance
    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.
    25 npm
    8
    MIT