이 페이지에서는 언어 프롬프트가 포함된 실용적인 예시를 통해 MongoDB MCP 서버를 사용하는 방법을 보여줍니다. 각 예시 AI 클라이언트에 입력할 수 있는 프롬프트와 LLM(대규모 언어 모델)에서 받을 수 있는 응답 예시를 보여줍니다.
이 페이지의 예시를 MongoDB MCP 서버와의 상호 작용을 위한 출발점으로 사용할 수 있습니다.
참고
정확한 출력은 데이터, AI 클라이언트, 사용 중인 LLM에 따라 달라집니다. 이 예시에서는 조직 ID, 프로젝트 ID, 비밀번호와 같은 비공개 정보가 삭제되었습니다.
전제 조건
이 예시를 실행하기 전에 다음 사항이 있는지 확인하세요.
작동 중인 MongoDB MCP 서버 구성
탐색할 데이터가 있는 MongoDB deployment 에 액세스합니다.
배포서버 에 로드된 샘플 데이터입니다.
Atlas 관리
다음 예제는 MongoDB MCP 서버를 사용하여 Atlas 인프라를 관리 방법을 보여줍니다.
조직 및 프로젝트 보기
Atlas 계정 구조와 사용 가능한 리소스에 대한 개요를 확인하세요.
Show my Atlas organizations and projects
Atlas 클러스터 생성
단일 워크플로에서 클러스터 와 필요한 모든 액세스 구성을 사용하여 새 Atlas 프로젝트 설정하세요.
Create a new Atlas project named myNewProject and create a free cluster named myNewCluster in the new project, add access list for my current IP, create a database user named myNewUser with read and write access to the new cluster, and return the connection string for the new cluster
지원되는 Atlas 리전 나열
Atlas cloud 제공자 에 대해 지원하는 리전 코드와 사람이 읽을 수 있는 위치를 조회하려면 atlas-get-regions을 사용합니다. 이는 "Iowa"와 같은 자연어 위치 확인하는 데 유용합니다. 또는 "북부 유럽"을 atlas-create-cluster 및 atlas-upgrade-cluster와 같은 도구가 예상하는 정확한 리전 코드로 변경합니다.
What Atlas regions are available on GCP?
전용 Atlas 클러스터 만들기
atlas-create-cluster 을 사용하여 M10–M80 인스턴스 크기의 전용 Atlas 클러스터를 만듭니다. 대신 프리 티어 클러스터를 만들려면 atlas-create-free-cluster을 사용합니다.
이 도구에는 projectId, clusterName, provider, regions이 필요합니다.
Create a dedicated Atlas cluster named myDedicatedCluster in project myProject on AWS in US East
Non-Default Options
기본값이 아닌 클러스터 유형, 인스턴스 크기 또는 백업 설정을 지정하려면 프롬프트에 이러한 옵션을 포함하세요.
Create a dedicated Atlas cluster named myShardedCluster in project myProject on AWS in US East with cluster type SHARDED, instance size M30, and continuous backups enabled
여러 리전
여러 리전에 걸쳐 클러스터를 분산하려면 프롬프트에 최대 3개의 리전 이름을 입력합니다. 이 도구는 리전을 정렬된 목록으로 처리합니다. 첫 번째 리전이 가장 높은 우선 순위를 가지고 프라이머리 노드를 보유합니다. 이 도구는 투표 선택 가능 노드를 하나의 리전에 3개의 노드, 두 개의 리전에 2개 및 1개의 노드, 또는 세 개의 리전에 2개, 2개 및 1개의 노드로 분산합니다.
Create a dedicated Atlas cluster named myMultiRegionCluster in project myProject on AWS across US East, Ohio, and Ireland
고객 관리 키를 사용한 미사용 데이터 암호화
고객 관리형 키로 클러스터 암호화하려면 프롬프트에서 키 제공자 이름을 지정합니다. 제공자 프로젝트 에 이미 유효한 미사용 데이터 암호화 구성이 있어야 합니다. 이 도구는 기존 구성을 선택하지만 생성하거나 수정할 수는 없습니다. 키 제공자 구성하는 방법을 학습 고객 키 관리를 사용한 미사용 데이터 암호화를 참조하세요.
제공자를 지정하지 않은 경우 유효한 구성이 있으면 이 도구는 클러스터의 클라우드 공급자용으로 구성된 고객 managed 키를 사용합니다. 그렇지 않은 경우 클러스터는 기본 Atlas 미사용 데이터 암호화를 사용합니다.
Create a dedicated Atlas cluster named myEncryptedCluster in project myProject on AWS in US East, encrypted with our AWS customer-managed key
Atlas 클러스터 업그레이드
atlas-upgrade-cluster 도구는 다음 업그레이드 경로를 지원합니다.
Flex 무료
무료 M10
Flex to M10
또한 이 도구는 전용 클러스터 다른 M10~M80 인스턴스 크기로 확장하고 컴퓨팅 자동 확장 설정을 업데이트합니다.
클러스터에 연결됨
MCP 설정에서 연결 문자열 구성했거나 atlas-connect-cluster 도구를 사용하여 연결한 경우 MCP 서버는 연결에서 클러스터 이름, 프로젝트 및 현재 계층 추론합니다.
Upgrade my current Atlas cluster to Flex
클러스터에 연결되지 않음
활성 클러스터 연결이 없는 경우 프롬프트에 클러스터 이름과 프로젝트 제공합니다. 선택적으로 대상 계층, 제공자 및 리전 지정할 수 있습니다.
Upgrade my Atlas cluster named myFlexCluster in project myProject to M10 on AWS in US East
전용 클러스터 확장
전용 클러스터 확장하다 하려면 다음 옵션 중 하나 이상을 지정합니다.
새 인스턴스 크기
컴퓨팅 자동 확장 활성화 여부
자동 확장을 위한 최소 또는 최대 인스턴스 크기
Scale my Atlas cluster named myDedicatedCluster in project myProject to M30 and let it autoscale between M20 and M50
Atlas 클러스터 일시 중지 또는 재개
atlas-pause-resume-cluster 도구는 전용(M10+) Atlas 클러스터를 일시 중지하거나 다시 시작합니다. 무료 및 Flex 클러스터는 일시 중지할 수 없습니다.
이 도구에는 다음 매개 변수가 필요합니다:
projectIdclusterNameactionaction을PAUSE또는RESUME로 설정합니다.
클러스터 일시 중지
클러스터를 일시 중지하면 연결을 사용할 수 없게 됩니다. 계산 비용이 발생하지 않습니다. 클러스터가 현재 사용 중인 연결인 경우, 클러스터가 일시 중지된 후 MCP 서버가 자동으로 연결을 끊습니다.
Pause cluster test-cluster-1 from project XXX
클러스터 재개
클러스터를 다시 시작하면 연결을 위해 즉시 사용할 수 없습니다. atlas-inspect-cluster 을(를) 사용하여 클러스터 상태가 IDLE에 도달할 때까지 폴링합니다.
Resume cluster test-cluster-1 from project XXX
데이터 탐색
다음 예시는 MongoDB MCP 서버를 사용하여 MongoDB 데이터를 탐색하고 이해하는 방법을 보여줍니다.
사용 가능한 데이터베이스 나열
클러스터 에서 사용할 수 있는 데이터베이스를 검색하고 해당 콘텐츠에 대한 인사이트를 얻으세요.
Show my Atlas databases
컬렉션 살펴보기
특정 데이터베이스 자세히 살펴보고 해당 데이터베이스의 구조와 컬렉션을 파악하세요.
Show the collections in the Atlas sample_mflix database
데이터 분석
MongoDB 데이터를 분석하여 패턴과 추세를 식별합니다.
Summarize the Atlas movies collection by thrillers
데이터베이스 작업
다음 예시는 MongoDB MCP 서버를 사용하여 일반적인 데이터베이스 작업을 수행하는 방법을 보여줍니다.
새 문서 삽입
컬렉션에 새 데이터를 추가합니다.
Add a document to the movies_copy collection
새 컬렉션 만들기
새 컬렉션을 만들고 사용자 지정합니다.
Create a new collection to store movie purchases data that includes geospatial and timeseries fields
기존 컬렉션 복사
기존 컬렉션 의 백업 또는 복제본을 만듭니다.
Make a copy of the movies collection named movies_copy
데이터 내보내기 및 공유
다음 예시 외부 도구에서 공유 하거나 추가 처리 위해 쿼리 결과를 내보내는 방법을 보여줍니다.
포괄적인 보고서를 생성하고 다른 애플리케이션에서 사용하거나 팀 과 공유 수 있도록 내보낼 수 있습니다.
내보낸 결과는 MCP 서버를 실행하는 컴퓨터의 파일 에 저장됩니다. AI 클라이언트 애플리케이션 사용하여 exported-data 리소스 를 통해 내보낸 데이터에 액세스 할 수도 있습니다.
내보내기 파일 exportPath 구성 옵션에서 지정한 파일 시스템 경로에 저장됩니다. 내보내기 파일 exportTimeout 구성 옵션에 지정된 기간이 지나면 삭제할 수 있습니다. 자세한 내용은 MongoDB MCP 서버에서 데이터 내보내기를 참조하세요.
Summarize and export the contents of the movies collection.
로컬 Atlas 배포
MCP 서버를 로컬 Atlas 배포서버와 함께 사용할 수 있습니다. 로컬 Atlas 배포에서 MCP 서버 도구를 사용하려면 Docker 설치해야 합니다. 로컬 Atlas 배포서버에 대한 소개는 로컬 Atlas 배포서버 만들기.를 참조하세요.
다음 예제는 MongoDB MCP 서버를 사용하여 로컬 Atlas 배포서버와 상호 작용 하고 이를 생성하는 방법을 보여줍니다.
로컬 Atlas 배포 나열
다음 예시 에는 로컬 Atlas 배포서버가 나열되어 있습니다.
List all local Atlas deployments.
로컬 Atlas 배포서버에 연결 및 데이터베이스 나열
다음 예시 local7356 (이)라는 로컬 Atlas 배포서버 에 연결하고 데이터베이스를 나열합니다.
Connect to my local Atlas deployment local7356 and list the databases.
데이터베이스 및 컬렉션을 사용하여 새 로컬 Atlas 배포서버 만들기
다음 예시 데이터베이스 와 예시 컬렉션 사용하여 새 로컬 Atlas 배포서버 만듭니다. 예시 실행 하려면 읽기 전용 모드비활성화해야 합니다.
Create a new local Atlas deployment, connect to it, create a collection with sample pizza orders data, and then retrieve the sample data.
로컬 Atlas 배포서버 삭제
다음 예시 local5528라는 로컬 Atlas 배포서버 삭제합니다. 예시 실행 하려면 읽기 전용 모드비활성화해야 합니다.
Delete my local Atlas deployment local5528.
atlas-local-delete-deployment 도구가 로컬 Atlas 배포서버 삭제한 후 AI 클라이언트 배포서버 이미 삭제되었다고 응답할 수 있습니다. 이는 atlas-local-delete-deployment 도구가 성공적으로 실행되었고 로컬 Atlas 배포서버 더 이상 존재하지 않기 때문입니다.
성능 최적화
다음 예시는 MongoDB MCP 서버를 사용하여 성능 문제를 식별하고 해결하는 방법을 보여줍니다. 프롬프트의 실제 출력은 클러스터 성능 문제가 발생하고 있는지 여부에 따라 달라지므로 출력이 예시와 정확히 일치하지 않을 수 있습니다.
이 예제에서는 atlas-get-performance-advisor 도구를 사용하여 Performance Advisor에서 권장 사항을 조회 .
느린 쿼리 분석
성능이 느린 쿼리를 식별하고 분석 성능 병목 현상을 이해합니다.
참고
느린 쿼리 분석을 수행할 때 MongoDB MCP 서버는 50 쿼리로 제한되는 느린 쿼리 샘플 검색합니다. 샘플에는 최적의 성능과 응답 시간을 보장하기 위해 프롬프트에 지정된 조건과 일치하는 가장 최근의 느린 쿼리 최대 50 개가 포함되어 있습니다.
클러스터 의 모든 느린 쿼리를 쿼리합니다.
Show me slow queries in my cluster
일반적인 성능 문제를 쿼리합니다.
How is my cluster performance?
특정 작업 유형, 기간 또는 네임스페이스 를 쿼리합니다.
Show me slow writes for the past 24 hours in the movies collection
특정 실행 시간을 쿼리합니다.
Show me queries longer than 5 seconds
인덱스 추천 가져오기
Performance Advisor 사용하여 생성하거나 제거할 인덱스를 제안하여 성능을 개선할 수 있습니다.
What indexes should I create or drop to improve performance?
스키마 최적화
데이터베이스 스키마 설계 및 구조 개선을 위한 권장 사항을 확인하세요.
Suggest schema improvements for my database
Vector Search
다음 예시는 MongoDB MCP 서버를 사용하여 MongoDB 벡터 검색을 사용하는 방법을 보여줍니다. MCP 서버가 벡터 검색과 작동하는 방식에 대해 자세히 학습하려면 벡터 검색 지원을 참조하세요.
참고
자동 임베딩 생성을 사용하려면 MCP Voyage AI API 키로 서버를 구성해야 합니다.
벡터 검색 인덱스 생성 및 관리
컬렉션에 대한 벡터 검색 인덱스를 생성, 제거하다 및 나열합니다.
Create a vector search index on the sample_db.products collection for the embeddings field with 1024 dimensions using dot product similarity
Show me all vector search indexes on the sample_db.products collection
Drop the vector search index from the sample_db.products collection
자동 임베딩으로 문서 삽입
Voyage AI API 키를 구성하면 MCP 서버가 문서를 삽입할 때 임베딩을 자동으로 생성합니다. 원시 텍스트 값을 제공할 수 있으며, 서버 벡터 검색 인덱스가 있는 필드에 대한 임베딩을 생성합니다.
Insert documents into the sample_db database and products collection. Use the voyage-3-large embedding model to generate vector embeddings from descriptions for the `embeddings` field. 1. name: "Headphones", description: "Premium wireless noise-canceling headphones with 30-hour battery" 2. name: "Earbuds", description: "True wireless earbuds with active noise cancellation" 3. name: "Monitor", description: "24-inch 4K monitor with 1ms response time" 4. name: "Keyboard", description: "Mechanical keyboard with customizable RGB lighting" 5. name: "Mouse", description: "Wireless ergonomic mouse with programmable buttons"
벡터 검색 쿼리 실행
Voyage AI API 키를 구성하면 MCP 서버가 벡터 검색 쿼리를 실행할 때 임베딩을 자동으로 생성합니다. 원본 텍스트를 제공하면 서버 쿼리 에 대한 임베딩을 자동으로 생성합니다.
Run a vector search query on sample_db.products on the 'embeddings' field using the vector search index to find products that I can use to listen to music.
어휘 검색
다음 예제는 MongoDB MCP 서버를 사용하여 MongoDB Search를 사용하는 방법을 보여줍니다. MCP 서버가 어휘 검색 과 작동하는 방식에 대해 자세히 학습 어휘 검색 지원을 참조하세요.
어휘 검색 인덱스 생성 및 관리
컬렉션에 대한 어휘 검색 인덱스를 생성, 삭제 및 나열합니다.
Create a lexical search index on the sample_db.products collection for the description field
Show me all lexical search indexes on the sample_db.products collection
Drop the lexical search index from the sample_db.products collection
어휘 검색 쿼리 실행
$search 집계 단계를 사용하여 aggregate 도구로 어휘 검색 쿼리를 실행합니다.
Run a lexical search query on sample_db.products on the 'description' field using the lexical search index to find products that mention wireless.
어휘 검색 결과 메타데이터 가져오기
aggregate 도구를 집계 단계와 함께 $searchMeta 사용하여 일치하는 문서 자체 대신 어휘 검색 에 대한 메타데이터 (예: 일치하는 문서 수)를 반환합니다.
How many products have "wireless" in the description on sample_db.products using the lexical search index
다음 단계
MongoDB MCP 서버 구성 및 사용에 대한 자세한 내용은 다음을 참조하세요.