kuzu-mcp-server

一个模型上下文协议服务器，提供对 Kuzu 数据库的访问。该服务器使 LLM 能够检查数据库模式并在提供的 Kuzu 数据库上执行查询。

组件

工具

• getSchema

  • 获取 Kuzu 数据库的完整模式，包括所有节点和关系表及其属性
  • 输入：无

• query

  • 在 Kuzu 数据库上运行 Cypher 查询
  • 输入：cypher (字符串): 要运行的 Cypher 查询

Prompt

• generateKuzuCypher
  • 为 Kuzu 生成 Cypher 查询
  • 参数：question (字符串): 用于生成 Cypher 查询的自然语言问题

与 Claude Desktop 一起使用

使用 Docker (推荐)

• 编辑配置文件 config.json:
  • 在 macOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 在 Windows 上: %APPDATA%\Claude\claude_desktop_config.json
• 将以下配置添加到 mcpServers 对象：

  {
    "mcpServers": {
        "kuzu": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "{Kuzu 数据库的绝对路径}:/database",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ]
        }
    }
  }
  

  将 {Kuzu 数据库的绝对路径} 更改为实际路径
• 重启 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": [
                "{本仓库的绝对路径}/index.js",
                "{Kuzu 数据库的绝对路径}",
            ]
        }
    }
  }
  

  将 {本仓库的绝对路径} 和 {Kuzu 数据库的绝对路径} 更改为实际路径
• 重启 Claude Desktop

只读模式

可以通过将 KUZU_READ_ONLY 环境变量设置为 true 来在只读模式下运行服务器。 在此模式下，运行任何尝试修改数据库的查询都会导致错误。 可以在配置文件中设置此标志，如下所示：

{
    "mcpServers": {
        "kuzu": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "{Kuzu 数据库的绝对路径}:/database",
                "-e",
                "KUZU_READ_ONLY=true",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ],
        }
    }
}