Astra DB MCP 서버

Astra DB와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. MCP는 대규모 언어 모델(LLM)이 외부 시스템과 에이전트로 상호 작용할 수 있도록 하여 LLM의 기능을 확장합니다.

필수 조건

Astra DB 데이터베이스가 실행 중이어야 합니다. 데이터베이스가 없다면 여기에서 무료 데이터베이스를 만들 수 있습니다. 그러면 필요한 두 가지를 얻을 수 있습니다.

1. Astra DB 애플리케이션 토큰
2. Astra DB API 엔드포인트

이러한 기능을 사용하는 방법을 알아보려면 시작 문서를 읽어보세요 .

MCP 클라이언트에 추가

MCP 클라이언트에 이 서버를 추가하는 방법은 다음과 같습니다.

클로드 데스크탑

이것을 Claude Desktop 에 추가하려면 환경 설정 -> 개발자 -> 구성 편집으로 이동하여 이 JSON blob을 claude_desktop_config.json 에 추가하세요.

지엑스피1

Windows PowerShell 사용자: npx 는 일괄 명령이므로 다음과 같이 JSON을 수정하세요.

커서

커서 에 추가하려면 설정 -> 커서 설정 -> MCP로 이동하세요.

그곳에서 "+ 새 MCP 서버 추가" 버튼을 클릭하면 mcp.json 파일이 있는 곳으로 이동하여 서버를 추가할 수 있습니다.

팁 : 전역 MCP 설정을 나타내는 ~/.cursor/mcp.json 파일과 프로젝트별 .cursor/mcp.json 파일이 있습니다. 이 MCP 서버를 프로젝트별 파일에 설치하는 것이 좋습니다.

Claude Desktop 지침에 표시된 것과 동일한 JSON을 추가합니다.

또는 다음 값을 입력할 수 있는 마법사가 나타날 수도 있습니다(Unix 기반 시스템의 경우):

• 이름 : 원하는 대로
• 유형: 명령
• 명령:

편집자가 추가되면 Astra DB 데이터베이스에 완전히 연결됩니다.

사용 가능한 도구

서버는 Astra DB와 상호 작용하기 위한 다음과 같은 도구를 제공합니다.

• GetCollections : 데이터베이스의 모든 컬렉션을 가져옵니다.
• CreateCollection : 데이터베이스에 새 컬렉션을 만듭니다.
• UpdateCollection : 데이터베이스의 기존 컬렉션을 업데이트합니다.
• DeleteCollection : 데이터베이스에서 컬렉션을 삭제합니다.
• ListRecords : 데이터베이스의 컬렉션에서 레코드를 나열합니다.
• GetRecord : ID로 컬렉션에서 특정 레코드를 가져옵니다.
• CreateRecord : 컬렉션에 새 레코드를 만듭니다.
• UpdateRecord : 컬렉션의 기존 레코드를 업데이트합니다.
• DeleteRecord : 컬렉션에서 레코드 삭제
• FindRecord : 필드 값으로 컬렉션에서 레코드 찾기
• BulkCreateRecords : 컬렉션에 여러 레코드를 한 번에 만듭니다.
• BulkUpdateRecords : 컬렉션의 여러 레코드를 한 번에 업데이트합니다.
• BulkDeleteRecords : 컬렉션에서 여러 레코드를 한 번에 삭제합니다.
• OpenBrowser : 인증 및 설정을 위해 웹 브라우저를 엽니다.
• HelpAddToClient : MCP 클라이언트에 Astra DB 클라이언트를 추가하는 데 도움을 받으세요.
• EstimateDocumentCount : 컬렉션에 있는 문서 수를 추정합니다.