카우치디비-mcp-서버

CouchDB와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버

CouchDB 데이터베이스 및 문서 관리 도구를 제공하는 TypeScript 기반 MCP 서버입니다. AI 어시스턴트가 간단한 인터페이스를 통해 CouchDB와 상호 작용할 수 있도록 지원합니다.

특징

도구

기본 도구(모든 CouchDB 버전)

• createDatabase - 새로운 CouchDB 데이터베이스 생성

  • dbName 필수 매개변수로 사용합니다.

  • 데이터베이스가 존재하지 않으면 생성합니다.

• listDatabases - 모든 CouchDB 데이터베이스 나열

  • 데이터베이스 이름 배열을 반환합니다.

• deleteDatabase - CouchDB 데이터베이스 삭제

  • dbName 필수 매개변수로 사용합니다.

  • 지정된 데이터베이스와 해당 모든 문서를 제거합니다.

• createDocument - 데이터베이스에서 새 문서를 만들거나 기존 문서를 업데이트합니다.

  • 필수 매개변수:

    • dbName : 데이터베이스 이름

    • docId : 문서 ID

    • data : 문서 데이터(JSON 객체)

      • 업데이트의 경우 현재 문서 개정 내용을 포함하는 _rev 필드를 포함합니다.

  • 보고:

    • 새 문서의 경우: 문서 ID 및 새 개정판

    • 업데이트: 문서 ID 및 업데이트된 개정판

  • _rev 필드의 존재 여부에 따라 작업이 생성되는지 업데이트되는지 자동으로 감지합니다.

• getDocument - 데이터베이스에서 문서 가져오기

  • 필수 매개변수:

    • dbName : 데이터베이스 이름

    • docId : 문서 ID

  • 문서 내용을 반환합니다

Mango 쿼리 도구(CouchDB 3.x+ 전용)

• createMangoIndex - 새로운 Mango 인덱스를 만듭니다.

  • 필수 매개변수:

    • dbName : 데이터베이스 이름

    • indexName : 인덱스의 이름

    • fields : 인덱싱할 필드 이름의 배열

  • 효율적인 쿼리를 위해 새 인덱스를 생성합니다.

• deleteMangoIndex - Mango 인덱스 삭제

  • 필수 매개변수:

    • dbName : 데이터베이스 이름

    • designDoc : 디자인 문서 이름

    • indexName : 인덱스의 이름

  • 기존 Mango 인덱스를 제거합니다.

• listMangoIndexes - 데이터베이스의 모든 Mango 인덱스 나열

  • 필수 매개변수:

    • dbName : 데이터베이스 이름

  • 데이터베이스의 모든 인덱스에 대한 정보를 반환합니다.

• findDocuments - Mango 쿼리를 사용하여 문서 쿼리

  • 필수 매개변수:

    • dbName : 데이터베이스 이름

    • query : Mango 쿼리 객체

  • CouchDB의 Mango 쿼리 구문을 사용하여 쿼리를 수행합니다.

Related MCP server: TDengine Query MCP Server

버전 지원

서버는 CouchDB 버전을 자동으로 감지하고 그에 따라 기능을 활성화합니다.

• 모든 버전: 기본 데이터베이스 및 문서 작업

• CouchDB 3.x+: Mango 쿼리 지원(인덱스 및 쿼리)

구성

서버에는 CouchDB 연결 URL과 버전이 필요합니다. 이는 환경 변수를 통해 제공할 수 있습니다.

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 couchdb-mcp-server를 자동으로 설치하려면:

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

필수 조건

• Node.js 14 이상

• CouchDB 인스턴스 실행

• 인증이 활성화된 경우 적절한 CouchDB 자격 증명

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

오류 처리

서버에는 일반적인 시나리오에 대한 강력한 오류 처리 기능이 포함되어 있습니다.

• 잘못된 데이터베이스 이름 또는 문서 ID

• 데이터베이스가 이미 존재합니다/존재하지 않습니다

• 연결 문제

• 인증 실패

• 잘못된 문서 데이터

모든 오류는 올바르게 형식화되어 적절한 오류 코드 및 메시지와 함께 MCP 프로토콜을 통해 반환됩니다.