kuzu-mcp-server

kuzu-mcp-serverは、KuzuデータベースにアクセスするためのModel Context Protocolサーバーです。このサーバーは、LLM(大規模言語モデル)がデータベーススキーマを検査し、指定されたKuzuデータベース上でクエリを実行することを可能にします。主にJavaScriptで実装されており、DockerやNode.jsを使用して簡単にセットアップできます。データベースのスキーマを取得したり、Cypherクエリを実行したりするためのツールが用意されており、開発者はこれを利用してデータベース操作を自動化できます。

GitHubスター

18

ユーザー評価

未評価

フォーク

11

イシュー

1

閲覧数

0

お気に入り

0

README
kuzu-mcp-server

A Model Context Protocol server that provides access to Kuzu databases. This server enables LLMs to inspect database schemas and execute queries on provided kuzu database.

Components
Tools
  • getSchema

    • Fetch the full schema of the Kuzu database, including all nodes and relationships tables and their properties
    • Input: None
  • query

    • Run a Cypher query on the Kuzu database
    • Input: cypher (string): The Cypher query to run
Prompt
  • generateKuzuCypher
    • Generate a Cypher query for Kuzu
    • Argument: question (string): The question in natural language to generate the Cypher query for
Usage with Claude Desktop
With Docker (Recommended)
  • Edit the configuration file config.json:
    • on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • on Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Add the following configuration to the mcpServers object:
    {
      "mcpServers": {
          "kuzu": {
              "command": "docker",
              "args": [
                  "run",
                  "-v",
                  "{Absolute Path to the Kuzu database}:/database",
                  "--rm",
                  "-i",
                  "kuzudb/mcp-server"
              ]
          }
      }
    }
    
    Change the {Absolute Path to the Kuzu database} to the actual path
  • Restart Claude Desktop
With Node.js and npm (for Development)
  • Install dependencies: npm install
  • Edit the configuration file config.json:
    • on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • on Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Add the following configuration to the mcpServers object:
    {
      "mcpServers": {
          "kuzu": {
              "command": "node",
              "args": [
                  "{Absolute Path to this repository}/index.js",
                  "{Absolute Path to the Kuzu database}",
              ]
          }
      }
    }
    
    Change the {Absolute Path to this repository} and {Absolute Path to the Kuzu database} to the actual paths
  • Restart Claude Desktop
Read-Only Mode

The server can be run in read-only mode by setting the KUZU_READ_ONLY environment variable to true. In this mode, running any query that attempts to modify the database will result in an error. This flag can be set in the configuration file as follows:

{
    "mcpServers": {
        "kuzu": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "{Absolute Path to the Kuzu database}:/database",
                "-e",
                "KUZU_READ_ONLY=true",
                "--rm",
                "-i",
                "kuzudb/mcp-server"
            ],
        }
    }
}
作者情報
Kùzu
Waterloo, Canada

81

フォロワー

21

リポジトリ

0

Gist

24

貢献数

トップ貢献者

スレッド