Kuzu

Inspeccionar esquemas y ejecutar consultas en bases de datos Kuzu.

Documentación

kuzu-mcp-server

Un servidor de Model Context Protocol que proporciona acceso a bases de datos Kuzu. Este servidor permite a los LLMs inspeccionar esquemas de bases de datos y ejecutar consultas en la base de datos kuzu proporcionada.

Componentes

Herramientas

getSchema
- Obtener el esquema completo de la base de datos Kuzu, incluyendo todas las tablas de nodos y relaciones y sus propiedades
- Entrada: Ninguna
query
- Ejecutar una consulta Cypher en la base de datos Kuzu
- Entrada: cypher (cadena): La consulta Cypher a ejecutar

Prompt

generateKuzuCypher
- Generar una consulta Cypher para Kuzu
- Argumento: question (cadena): La pregunta en lenguaje natural para la cual generar la consulta Cypher

Uso con Claude Desktop

Con Docker (Recomendado)

Editar el archivo de configuración config.json:
- en macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- en Windows: %APPDATA%\Claude\claude_desktop_config.json

Agregar la siguiente configuración al objeto mcpServers:

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

Cambiar el {Path to the directory containing Kuzu database file} a la ruta real

Reiniciar Claude Desktop

Con Node.js y npm (para Desarrollo)

Instalar dependencias: npm install
Editar el archivo de configuración config.json:
- en macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- en Windows: %APPDATA%\Claude\claude_desktop_config.json

Agregar la siguiente configuración al objeto mcpServers:

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

Cambiar el {Absolute Path to this repository} y {Absolute Path to the Kuzu database file} a las rutas reales

Reiniciar Claude Desktop

Modo de Solo Lectura

El servidor puede ejecutarse en modo de solo lectura estableciendo la variable de entorno KUZU_READ_ONLY a true. En este modo, ejecutar cualquier consulta que intente modificar la base de datos resultará en un error. Esta bandera se puede configurar en el archivo de configuración de la siguiente manera:

{
    "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"
            ],
        }
    }
}