kuzu-mcp-server

一个提供对Kuzu数据库访问的模型上下文协议（Model Context Protocol）服务器。此服务器使大型语言模型能够 inspect 检查数据库架构并执行查询到提供的Kuzu数据库。

组件

工具

• getSchema

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

• query

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

提示

• 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",
                "{Absolute Path to the Kuzu database}:/database",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ]
        }
    }
  }
  

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