servidor kuzu-mcp

Un servidor de Protocolo de Contexto de Modelo que proporciona acceso a las bases de datos de Kuzu. Este servidor permite a los LLM inspeccionar los esquemas de las bases de datos y ejecutar consultas en la base de datos de Kuzu proporcionada.

Componentes

Herramientas

• obtenerEsquema

  • Obtenga el esquema completo de la base de datos Kuzu, incluidos todos los nodos y las tablas de relaciones y sus propiedades.

  • Entrada: Ninguna

• consulta

  • Ejecutar una consulta Cypher en la base de datos Kuzu

  • Entrada: cypher (cadena): La consulta Cypher que se ejecutará

Inmediato

• generarKuzuCypher

  • Generar una consulta Cypher para Kuzu

  • Argumento: question (cadena): La pregunta en lenguaje natural para generar la consulta Cypher.

Related MCP server: MCP-Python

Uso con Claude Desktop

Con Docker (recomendado)

• Edite 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

• Agregue la siguiente configuración al objeto mcpServers :

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

  Cambie la {Absolute Path to the Kuzu database} por la ruta real

• Reiniciar Claude Desktop

Con Node.js y npm (para desarrollo)

• Instalar dependencias: npm install

• Edite 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

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

  Cambie {Absolute Path to this repository} y {Absolute Path to the Kuzu database} por las rutas reales

• Reiniciar Claude Desktop

Modo de solo lectura

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

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