쿠즈-mcp-서버

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

구성 요소

도구

getSchema
- 모든 노드와 관계 테이블 및 해당 속성을 포함하여 Kuzu 데이터베이스의 전체 스키마를 가져옵니다.
- 입력: 없음
질문
- Kuzu 데이터베이스에서 Cypher 쿼리 실행
- 입력: cypher (문자열): 실행할 Cypher 쿼리

즉각적인

KuzuCypher 생성
- 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 개체에 다음 구성을 추가합니다.지엑스피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"
            ],
        }
    }
}