kuzu-mcp-server

一个提供访问Kuzu数据库的Model Context Protocol服务器。此服务器使LLMs能够检查数据库模式并在提供的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",
                "{包含Kuzu数据库文件的目录路径}:/database",
                "-e",
                "KUZU_DB_FILE={Kuzu数据库文件名}",
                "--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_DB_FILE={Kuzu数据库文件名}",
                "-e",
                "KUZU_READ_ONLY=true",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ],
        }
    }
}