AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

MongoDB MCP 서버 사용 예시

이 페이지에서는 언어 프롬프트가 포함된 실용적인 예시를 통해 MongoDB MCP 서버를 사용하는 방법을 보여줍니다. 각 예시 AI 클라이언트에 입력할 수 있는 프롬프트와 LLM(대규모 언어 모델)에서 받을 수 있는 응답 예시를 보여줍니다.

이 페이지의 예시를 MongoDB MCP 서버와의 상호 작용을 위한 출발점으로 사용할 수 있습니다.

참고

정확한 출력은 데이터, AI 클라이언트, 사용 중인 LLM에 따라 달라집니다. 이 예시에서는 조직 ID, 프로젝트 ID, 비밀번호와 같은 비공개 정보가 삭제되었습니다.

이 예시를 실행하기 전에 다음 사항이 있는지 확인하세요.

다음 예제는 MongoDB MCP 서버를 사용하여 Atlas 인프라를 관리 방법을 보여줍니다.

Atlas 계정 구조와 사용 가능한 리소스에 대한 개요를 확인하세요.

Show my Atlas organizations and projects

단일 워크플로에서 클러스터 와 필요한 모든 액세스 구성을 사용하여 새 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 cloud 제공자 에 대해 지원하는 리전 코드와 사람이 읽을 수 있는 위치를 조회하려면 atlas-get-regions을 사용합니다. 이는 "Iowa"와 같은 자연어 위치 확인하는 데 유용합니다. 또는 "북부 유럽"을 atlas-create-cluster 및 atlas-upgrade-cluster와 같은 도구가 예상하는 정확한 리전 코드로 변경합니다.

What Atlas regions are available on GCP?

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-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-pause-resume-cluster 도구는 전용(M10+) Atlas 클러스터를 일시 중지하거나 다시 시작합니다. 무료 및 Flex 클러스터는 일시 중지할 수 없습니다.

이 도구에는 다음 매개 변수가 필요합니다:

  • projectId

  • clusterName

  • actionaction 을 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.

MCP 서버를 로컬 Atlas 배포서버와 함께 사용할 수 있습니다. 로컬 Atlas 배포에서 MCP 서버 도구를 사용하려면 Docker 설치해야 합니다. 로컬 Atlas 배포서버에 대한 소개는 로컬 Atlas 배포서버 만들기.를 참조하세요.

다음 예제는 MongoDB MCP 서버를 사용하여 로컬 Atlas 배포서버와 상호 작용 하고 이를 생성하는 방법을 보여줍니다.

다음 예시 에는 로컬 Atlas 배포서버가 나열되어 있습니다.

List all local Atlas deployments.

다음 예시 local7356 (이)라는 로컬 Atlas 배포서버 에 연결하고 데이터베이스를 나열합니다.

Connect to my local Atlas deployment local7356 and list the
databases.

다음 예시 데이터베이스 와 예시 컬렉션 사용하여 새 로컬 Atlas 배포서버 만듭니다. 예시 실행 하려면 읽기 전용 모드비활성화해야 합니다.

Create a new local Atlas deployment, connect to it, create a
collection with sample pizza orders data, and then retrieve the
sample data.

다음 예시 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

다음 예시는 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 서버 구성 및 사용에 대한 자세한 내용은 다음을 참조하세요.

사용 가능한 모든 구성 옵션 및 연결 방법에 대한 학습.

전체 도구 목록과 해당 역량을 살펴보세요.

MCP 서버를 안전하게 배포 하고 사용하는 방법을 이해합니다.