Kuzu

kuzu-mcp-server

Um servidor de Model Context Protocol que fornece acesso a bancos de dados Kuzu. Este servidor permite que LLMs inspecionem esquemas de banco de dados e executem consultas no banco de dados kuzu fornecido.

Componentes

Ferramentas

• getSchema

  • Busca o esquema completo do banco de dados Kuzu, incluindo todas as tabelas de nós e relacionamentos e suas propriedades
  • Entrada: Nenhuma

• query

  • Executa uma consulta Cypher no banco de dados Kuzu
  • Entrada: cypher (string): A consulta Cypher a ser executada

Prompt

• generateKuzuCypher
  • Gera uma consulta Cypher para Kuzu
  • Argumento: question (string): A pergunta em linguagem natural para gerar a consulta Cypher

Uso com Claude Desktop

Com Docker (Recomendado)

• Edite o arquivo de configuração config.json:
  • no macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • no Windows: %APPDATA%\Claude\claude_desktop_config.json
• Adicione a seguinte configuração ao 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"
            ]
        }
    }
  }
  

  Altere o {Path to the directory containing Kuzu database file} para o caminho real
• Reinicie o Claude Desktop

Com Node.js e npm (para Desenvolvimento)

• Instale as dependências: npm install
• Edite o arquivo de configuração config.json:
  • no macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • no Windows: %APPDATA%\Claude\claude_desktop_config.json
• Adicione a seguinte configuração ao objeto mcpServers:

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

  Altere o {Absolute Path to this repository} e o {Absolute Path to the Kuzu database file} para os caminhos reais
• Reinicie o Claude Desktop

Modo Somente Leitura

O servidor pode ser executado em modo somente leitura definindo a variável de ambiente KUZU_READ_ONLY para true. Nesse modo, executar qualquer consulta que tente modificar o banco de dados resultará em um erro. Essa flag pode ser definida no arquivo de configuração da seguinte forma:

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