remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Supports configuration through environment variables that can be stored in a .env file for CouchDB connection settings.
Provides specific configuration path information for Claude Desktop integration on macOS systems.
Serves as the runtime environment for the MCP server, with version 14 or higher required as a prerequisite.

카우치디비-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 쿼리 구문을 사용하여 쿼리를 수행합니다.

버전 지원

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

모든 버전: 기본 데이터베이스 및 문서 작업
CouchDB 3.x+: Mango 쿼리 지원(인덱스 및 쿼리)

구성

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

지엑스피1

서버를 빌드하세요:

npm run build

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

npm run watch

설치

Smithery를 통해 설치

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

npx -y @smithery/cli install @robertoamoreno/couchdb-mcp-server --client claude

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

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

{
  "mcpServers": {
    "couchdb-mcp-server": {
      "command": "/path/to/couchdb-mcp-server/build/index.js",
      "env": {
        "COUCHDB_URL": "http://username:password@localhost:5984"
      }
    }
  }
}

필수 조건

Node.js 14 이상
CouchDB 인스턴스 실행
인증이 활성화된 경우 적절한 CouchDB 자격 증명

디버깅

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

npm run inspector

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

오류 처리

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

잘못된 데이터베이스 이름 또는 문서 ID
데이터베이스가 이미 존재합니다/존재하지 않습니다
연결 문제
인증 실패
잘못된 문서 데이터

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

AI 어시스턴트가 간단한 인터페이스를 통해 CouchDB 데이터베이스와 상호 작용할 수 있도록 하는 TypeScript 기반 MCP 서버로, 데이터베이스와 문서를 만들고, 읽고, 쿼리하기 위한 도구를 제공합니다.

Related Resources

Reddit Discussion about this server

CouchDB MCP Server