카우치베이스 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++ 쿼리로 변환합니다. 그 결과는 읽을 수 있는 형식으로 사용자에게 반환됩니다.

설정

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

지엑스피1

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

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

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

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

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

특징

Couchbase 쿼리 도구

• 도구 이름: query-couchbase
• 설명: Couchbase Capella 클러스터에서 SQL++ 쿼리 문을 실행합니다.
• 사용법 : 호출 시 서버는 Couchbase Node.js SDK를 사용하여 제공된 SQL++ 쿼리를 실행하고 결과를 반환합니다.

개발 중

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

1. 종속성 설치:

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

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

3. 디버깅

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

기여하다

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

특허

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