MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-12 20:29
태그:
#MCP #데이터베이스 #벡터 #써드파티 #DataStax

링크된 문서

역링크

Astra DB MCP 서버

Astra DB MCP 서버

Astra DB MCP 서버는 DataStax에서 제공하는 Model Context Protocol(MCP) 서버 구현체로, Astra DB와 상호작용할 수 있는 기능을 제공합니다. MCP를 통해 대규모 언어 모델(LLM)이 외부 시스템과 에이전트로서 상호작용할 수 있는 기능을 확장합니다.

주요 기능

  • 데이터 저장 및 검색: Astra DB를 통한 데이터 저장 및 벡터 검색 제공
  • 컬렉션 관리: 컬렉션 생성, 수정, 삭제 및 조회 기능
  • 레코드 조작: 레코드 생성, 조회, 업데이트, 삭제 기능
  • 대량 작업 지원: 여러 레코드를 한 번에 생성, 업데이트, 삭제하는 기능
  • 인증 지원: 브라우저를 통한 인증 및 설정 지원

사전 요구사항

Astra DB MCP 서버를 사용하기 위해서는 다음이 필요합니다:

  1. 실행 중인 Astra DB 데이터베이스 (무료 데이터베이스는 여기에서 생성 가능)
  2. Astra DB 애플리케이션 토큰
  3. Astra DB API 엔드포인트

제공 도구

Astra DB MCP 서버는 다음과 같은 도구를 제공합니다:

컬렉션 관리 도구

  • GetCollections: 데이터베이스의 모든 컬렉션 조회
  • CreateCollection: 데이터베이스에 새 컬렉션 생성
  • UpdateCollection: 기존 컬렉션 업데이트
  • DeleteCollection: 데이터베이스에서 컬렉션 삭제

레코드 조작 도구

  • ListRecords: 컬렉션에서 레코드 목록 조회
  • GetRecord: ID로 특정 레코드 조회
  • CreateRecord: 컬렉션에 새 레코드 생성
  • UpdateRecord: 기존 레코드 업데이트
  • DeleteRecord: 컬렉션에서 레코드 삭제
  • FindRecord: 필드 값으로 레코드 검색

대량 작업 도구

  • BulkCreateRecords: 한 번에 여러 레코드 생성
  • BulkUpdateRecords: 한 번에 여러 레코드 업데이트
  • BulkDeleteRecords: 한 번에 여러 레코드 삭제

기타 도구

  • OpenBrowser: 인증 및 설정을 위한 웹 브라우저 열기
  • HelpAddToClient: MCP 클라이언트에 Astra DB 클라이언트 추가 지원
  • EstimateDocumentCount: 컬렉션의 문서 수 추정

설정 방법

Claude Desktop에 추가하기

Claude Desktop의 claude_desktop_config.json 파일에 다음 JSON 블록을 추가합니다:

{
  "mcpServers": {
    "astra-db-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@datastax/astra-db-mcp"
      ],
      "env": {
        "ASTRA_DB_APPLICATION_TOKEN": "your_astra_db_token",
        "ASTRA_DB_API_ENDPOINT": "your_astra_db_endpoint"
      }
    }
  }
}

Windows PowerShell 사용자

Windows PowerShell에서는 npx가 배치 명령이므로 다음과 같이 JSON을 수정해야 합니다:

"command": "cmd",
"args": [
  "/k",
  "npx",
  "-y",
  "@datastax/astra-db-mcp"
],

Cursor에 추가하기

Cursor에서는 Settings -> Cursor Settings -> MCP로 이동합니다. "+ Add New MCP Server" 버튼을 클릭하여 서버를 추가합니다.

설정 마법사에서 다음 값을 입력하세요 (Unix 기반 시스템의 경우): - 이름: 원하는 이름 - 유형: Command - 명령어: env ASTRA_DB_APPLICATION_TOKEN=your_astra_db_token ASTRA_DB_API_ENDPOINT=your_astra_db_endpoint npx -y @datastax/astra-db-mcp

사용 사례

  • 지식 베이스 구축: 기업 또는 개인 데이터로 지식 베이스 구축
  • 벡터 검색 통합: LLM 애플리케이션에 벡터 검색 기능 통합
  • 메타데이터 필터링: 문서 메타데이터를 기반으로 검색 결과 필터링
  • 데이터 조작: AI 에이전트가 자율적으로 데이터를 저장하고 검색
  • RAG(Retrieval-Augmented Generation): 생성형 AI의 응답을 개선하기 위한 검색 증강

라이센스

이 서버는 Apache 2.0 라이센스에 따라 라이센스가 부여됩니다.

관련 링크