카우치베이스 MCP 서버
모델 컨텍스트 프로토콜(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 상호작용을 처리하는 프로토콜입니다 . 이 저장소는 Couchbase Node.js SDK를 사용하여 Couchbase MCP 서버를 구현하며, 이를 통해 MCP 클라이언트(예: Claude Desktop)가 Couchbase Capella 클러스터에서 자연어 쿼리를 수행할 수 있도록 합니다.
이 서버에서는 다음과 같은 명령을 사용할 수 있습니다.
Show me the results of SELECT * FROM my_bucket LIMIT 10Execute this query: SELECT name, age FROM users WHERE active = trueGet me the latest 5 documents from my_bucketSummarize the latest 5 orders from the orders bucket for me
예
다음 스크린샷은 Claude Desktop 클라이언트와 함께 작동하는 MCP 서버를 보여줍니다. 사용자가 일반 영어로 된 일반 요청을 보내면 MCP 서버는 이를 Couchbase Capella 클러스터에 대해 실행되는 SQL++ 쿼리로 변환합니다. 그 결과는 읽을 수 있는 형식으로 사용자에게 반환됩니다.
Related MCP server: Couchbase MCP Server for LLMs
설정
저장소를 복제하고 종속성을 설치합니다.
지엑스피1
루트 디렉토리에
.env파일을 만들고 Couchbase 연결 문자열, 사용자 이름, 비밀번호를 추가합니다.
필요한 환경 변수는 .env.sample 파일을 참조하세요.
프로젝트를 빌드하세요:
Stdio 전송을 사용하여 서버를 실행합니다.
MCP 서버는 StdioServerTransport를 사용하므로 표준 입출력(STIO)을 통해 통신합니다. MCP 클라이언트(예: Claude Desktop)가 로컬 MCP 서버를 사용하도록 구성되어 있는지 확인하세요.Claude Desktop 설명서를 참조하여 MCP 클라이언트가 로컬 서버에 연결되도록 설정하세요.
특징
Couchbase 쿼리 도구
도구 이름:
query-couchbase설명: Couchbase Capella 클러스터에서 SQL++ 쿼리 문을 실행합니다.
사용법 : 호출 시 서버는 Couchbase Node.js SDK를 사용하여 제공된 SQL++ 쿼리를 실행하고 결과를 반환합니다.
개발 중
프로젝트를 현지에서 진행하려면:
종속성 설치:
MCP 클라이언트를 사용하여 서버를 테스트합니다.
샘플 쿼리를 사용하여 도구에 연결하고 호출하도록 구성된 MCP 클라이언트(예: Claude Desktop)를 실행합니다.
디버깅
모든 로깅 메시지는 stdout 에 MCP 프로토콜 JSON만 포함되도록 stderr 로 전송됩니다. 자세한 연결 및 오류 메시지는 로그에서 확인하세요.
기여하다
기여를 환영합니다! 자유롭게 풀 리퀘스트를 제출하거나 제안 사항을 이슈에 올려주세요. 변경 사항이 있을 경우 프로젝트의 코드 스타일을 준수해 주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.
