Skip to main content
Glama
Kuzu MCP server

Kuzu MCP server

Official
by kuzudb

쿠즈-mcp-서버

Kuzu 데이터베이스에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 데이터베이스 스키마를 검사하고 제공된 Kuzu 데이터베이스에서 쿼리를 실행할 수 있습니다.

구성 요소

도구

  • getSchema

    • 모든 노드와 관계 테이블 및 해당 속성을 포함하여 Kuzu 데이터베이스의 전체 스키마를 가져옵니다.

    • 입력: 없음

  • 질문

    • Kuzu 데이터베이스에서 Cypher 쿼리 실행

    • 입력: cypher (문자열): 실행할 Cypher 쿼리

즉각적인

  • KuzuCypher 생성

    • Kuzu에 대한 Cypher 쿼리 생성

    • 인수: question (문자열): Cypher 쿼리를 생성하기 위한 자연어 질문

Related MCP server: MCP-Python

Claude Desktop과 함께 사용

Docker 사용(권장)

  • 구성 파일 config.json 편집합니다.

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

    • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

  • mcpServers 개체에 다음 구성을 추가합니다.

    지엑스피1

    {Absolute Path to the Kuzu database} 를 실제 경로로 변경합니다.

  • Claude Desktop을 다시 시작하세요

Node.js와 npm(개발용)

  • 종속성 설치: npm install

  • 구성 파일 config.json 편집합니다.

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

    • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

  • mcpServers 개체에 다음 구성을 추가합니다.

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

    {Absolute Path to this repository} 및 {Absolute Path to the Kuzu database} 실제 경로로 변경합니다.

  • Claude Desktop을 다시 시작하세요

읽기 전용 모드

KUZU_READ_ONLY 환경 변수를 true 로 설정하면 서버를 읽기 전용 모드로 실행할 수 있습니다. 이 모드에서는 데이터베이스를 수정하려는 모든 쿼리를 실행하면 오류가 발생합니다. 이 플래그는 구성 파일에서 다음과 같이 설정할 수 있습니다.

{
    "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

Inputs: no named parameters.

queryC

Run a Cypher query on the Kuzu database

Inputs: cypher.

Tool Schema Changelog

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

Loading tool schema changelog…

    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.

    Related MCP Connectors

    Related MCP Servers

    • 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
      184 npm
      59
      MIT
    • 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
      -
    • A
      license
      C
      quality
      B
      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
      31 npm
      3
      MIT
    • 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.
      19 npm
      8
      MIT