카우치베이스 MCP 서버

모델 컨텍스트 프로토콜(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 상호작용을 처리하는 프로토콜입니다 . 이 저장소는 Couchbase Node.js SDK를 사용하여 Couchbase MCP 서버를 구현하며, 이를 통해 MCP 클라이언트(예: Claude Desktop)가 Couchbase Capella 클러스터에서 자연어 쿼리를 수행할 수 있도록 합니다.

이 서버에서는 다음과 같은 명령을 사용할 수 있습니다.

• Show me the results of SELECT * FROM my_bucket LIMIT 10

• Execute this query: SELECT name, age FROM users WHERE active = true

• Get me the latest 5 documents from my_bucket

• Summarize the latest 5 orders from the orders bucket for me

예

다음 스크린샷은 Claude Desktop 클라이언트와 함께 작동하는 MCP 서버를 보여줍니다. 사용자가 일반 영어로 된 일반 요청을 보내면 MCP 서버는 이를 Couchbase Capella 클러스터에 대해 실행되는 SQL++ 쿼리로 변환합니다. 그 결과는 읽을 수 있는 형식으로 사용자에게 반환됩니다.

Related MCP server: Couchbase MCP Server

설정

1. 저장소를 복제하고 종속성을 설치합니다.

지엑스피1

2. 루트 디렉토리에 .env 파일을 만들고 Couchbase 연결 문자열, 사용자 이름, 비밀번호를 추가합니다.

COUCHBASE_CONNECTION_STRING=couchbases://your-cluster.cloud.couchbase.com
COUCHBASE_USERNAME=your_username
COUCHBASE_PASSWORD=your_password

필요한 환경 변수는 .env.sample 파일을 참조하세요.

3. 프로젝트를 빌드하세요:

npm run build

4. Stdio 전송을 사용하여 서버를 실행합니다.

npx couchbase-mcp-server

[!NOTE] MCP 서버는 StdioServerTransport를 사용하므로 표준 입출력(STIO)을 통해 통신합니다. MCP 클라이언트(예: Claude Desktop)가 로컬 MCP 서버를 사용하도록 구성되어 있는지 확인하세요. Claude Desktop 설명서를 참조하여 MCP 클라이언트가 로컬 서버에 연결되도록 설정하세요.

특징

Couchbase 쿼리 도구

• 도구 이름: query-couchbase

• 설명: Couchbase Capella 클러스터에서 SQL++ 쿼리 문을 실행합니다.

• 사용법 : 호출 시 서버는 Couchbase Node.js SDK를 사용하여 제공된 SQL++ 쿼리를 실행하고 결과를 반환합니다.

개발 중

프로젝트를 현지에서 진행하려면:

1. 종속성 설치:

npm install
npm run build

2. MCP 클라이언트를 사용하여 서버를 테스트합니다.

샘플 쿼리를 사용하여 도구에 연결하고 호출하도록 구성된 MCP 클라이언트(예: Claude Desktop)를 실행합니다.

3. 디버깅

모든 로깅 메시지는 stdout 에 MCP 프로토콜 JSON만 포함되도록 stderr 로 전송됩니다. 자세한 연결 및 오류 메시지는 로그에서 확인하세요.

기여하다

기여를 환영합니다! 자유롭게 풀 리퀘스트를 제출하거나 제안 사항을 이슈에 올려주세요. 변경 사항이 있을 경우 프로젝트의 코드 스타일을 준수해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.