쿠즈-mcp-서버

Kuzu 데이터베이스에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 데이터베이스 스키마를 검사하고 제공된 Kuzu 데이터베이스에서 쿼리를 실행할 수 있습니다.

구성 요소

도구

• getSchema

  • 모든 노드와 관계 테이블 및 해당 속성을 포함하여 Kuzu 데이터베이스의 전체 스키마를 가져옵니다.

  • 입력: 없음

• 질문

  • Kuzu 데이터베이스에서 Cypher 쿼리 실행

  • 입력: cypher (문자열): 실행할 Cypher 쿼리

즉각적인

• KuzuCypher 생성

  • Kuzu에 대한 Cypher 쿼리 생성

  • 인수: question (문자열): Cypher 쿼리를 생성하기 위한 자연어 질문

Related MCP server: MCP-Python

Claude Desktop과 함께 사용

Docker 사용(권장)

• 구성 파일 config.json 편집합니다.

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

• mcpServers 개체에 다음 구성을 추가합니다.

  지엑스피1

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