A
security-
licenseA
qualityA Model Context Protocol server that provides read-only access to MongoDB databases, enabling AI assistants to directly query and analyze MongoDB data while maintaining data safety.
Last updated -
14
61
7
MIT License
MongoDB MCP 서버
MongoDB 데이터베이스 및 MongoDB Atlas와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버입니다.
📚 목차
필수 조건
Node.js(v20.10.0 이상)
지엑스피1
MongoDB 연결 문자열이나 Atlas API 자격 증명이 구성되지 않으면 서버가 시작되지 않습니다 .
서비스 계정 Atlas API 자격 증명은 Atlas 도구를 사용하는 데 필요합니다. MongoDB Atlas에서 서비스 계정을 생성하고 해당 자격 증명을 사용하여 인증할 수 있습니다. 자세한 내용은 Atlas API 액세스를 참조하세요.
MongoDB 연결 문자열이 있으면 이를 사용하여 MongoDB 인스턴스에 직접 연결할 수 있습니다.
설정
빠른 시작
대부분의 MCP 클라이언트는 MCP 서버를 추가하기 위해 구성 파일을 만들거나 수정해야 합니다.
참고: 구성 파일 구문은 클라이언트마다 다를 수 있습니다. 최신 예상 구문은 다음 링크를 참조하세요.
옵션 1: 연결 문자열 인수
인수를 통해 연결 문자열을 전달할 수 있으며, 유효한 사용자 이름과 비밀번호를 사용해야 합니다.
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server",
"--connectionString",
"mongodb://localhost:27017/myDatabase"
]
}
}
}
참고: 연결 문자열은 로컬 인스턴스든 Atlas 클러스터든 모든 MongoDB 클러스터에 연결하도록 구성할 수 있습니다.
옵션 2: Atlas API 자격 증명 인수
Atlas API 서비스 계정 자격 증명을 사용하세요. Atlas API 액세스 섹션의 모든 단계를 따라야 합니다.
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server",
"--apiClientId",
"your-atlas-service-accounts-client-id",
"--apiClientSecret",
"your-atlas-service-accounts-client-secret"
]
}
}
}
옵션 3: 명령 인수를 사용하는 독립 실행형 서비스
npx 명령을 사용하여 서버를 시작합니다.
npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret"
인수의 전체 목록은 구성 옵션을 참조하세요.
Atlas 서비스 계정 자격 증명을 구성하려면 Atlas API 액세스 를 참조하세요.
옵션 4: 환경 변수를 사용하는 독립 실행형 서비스
npx -y mongodb-mcp-server
구성 파일에서 환경 변수를 사용하거나 환경 변수를 설정하고 npx를 통해 서버를 실행할 수 있습니다.
🛠️ 지원 도구
도구 목록
MongoDB Atlas 도구
atlas-list-orgs- MongoDB Atlas 조직 목록atlas-list-projects- MongoDB Atlas 프로젝트 목록atlas-create-project- 새로운 MongoDB Atlas 프로젝트를 생성합니다.atlas-list-clusters- MongoDB Atlas 클러스터 목록atlas-inspect-cluster- 특정 MongoDB Atlas 클러스터 검사atlas-create-free-cluster- 무료 MongoDB Atlas 클러스터 만들기atlas-connect-cluster- MongoDB Atlas 클러스터에 연결합니다.atlas-inspect-access-list- MongoDB Atlas 클러스터에 액세스하여 IP/CIDR 범위를 검사합니다.atlas-create-access-list- MongoDB Atlas 클러스터에 대한 IP/CIDR 액세스 목록 구성atlas-list-db-users- MongoDB Atlas 데이터베이스 사용자 목록atlas-create-db-user- MongoDB Atlas 데이터베이스 사용자를 생성합니다.atlas-list-alerts- 프로젝트에 대한 MongoDB Atlas 알림 목록
참고: Atlas 도구는 구성 섹션에서 자격 증명을 설정한 경우에만 사용할 수 있습니다.
MongoDB 데이터베이스 도구
connect- MongoDB 인스턴스에 연결find- MongoDB 컬렉션에 대해 find 쿼리를 실행합니다.aggregate- MongoDB 컬렉션에 대한 집계 실행count- MongoDB 컬렉션에 있는 문서 수를 가져옵니다.insert-one- MongoDB 컬렉션에 단일 문서 삽입insert-many- MongoDB 컬렉션에 여러 문서 삽입create-index- MongoDB 컬렉션에 대한 인덱스를 생성합니다.update-one- MongoDB 컬렉션의 단일 문서 업데이트update-many- MongoDB 컬렉션의 여러 문서 업데이트rename-collection- MongoDB 컬렉션 이름 바꾸기delete-one- MongoDB 컬렉션에서 단일 문서 삭제delete-many- MongoDB 컬렉션에서 여러 문서 삭제drop-collection- MongoDB 데이터베이스에서 컬렉션 제거drop-database- MongoDB 데이터베이스 제거list-databases- MongoDB 연결에 대한 모든 데이터베이스 나열list-collections- 주어진 데이터베이스에 대한 모든 컬렉션을 나열합니다.collection-indexes- 컬렉션의 인덱스를 설명합니다.collection-schema- 컬렉션의 스키마를 설명합니다.collection-storage-size- 컬렉션 크기를 MB 단위로 가져옵니다.db-stats- MongoDB 데이터베이스에 대한 통계를 반환합니다.
구성
MongoDB MCP 서버는 여러 가지 방법을 사용하여 구성할 수 있으며, 우선순위는 다음과 같습니다(가장 높은 것부터 가장 낮은 것까지):
명령줄 인수
환경 변수
구성 옵션
옵션 | 설명 |
| 인증을 위한 Atlas API 클라이언트 ID |
| 인증을 위한 Atlas API 클라이언트 비밀번호 |
| 직접 데이터베이스 연결을 위한 MongoDB 연결 문자열(선택 사항 사용자는 모든 도구 호출 시 이를 알리도록 선택할 수 있음) |
| 로그를 저장할 폴더 |
| 비활성화될 도구 이름, 작업 유형 및/또는 도구 범주의 배열 |
| true로 설정하면 읽기 및 메타데이터 작업 유형만 허용되고 생성/업데이트/삭제 작업은 비활성화됩니다. |
| 비활성화로 설정하면 원격 측정 수집이 비활성화됩니다. |
로그 경로
기본 로그 위치는 다음과 같습니다.
윈도우:
%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logsmacOS/Linux:
~/.mongodb/mongodb-mcp/.app-logs
장애인 도구
disabledTools 옵션을 사용하여 특정 도구 또는 도구 범주를 비활성화할 수 있습니다. 이 옵션은 문자열 배열을 허용하며, 각 문자열은 도구 이름, 작업 유형 또는 범주일 수 있습니다.
배열이 구성되는 방식은 사용하는 구성 방법의 유형에 따라 달라집니다.
환경 변수 를 구성하려면 쉼표로 구분된 문자열을 사용하세요:
export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema".명령줄 인수 구성의 경우 공백으로 구분된 문자열을 사용하세요:
--disabledTools create update delete atlas collectionSchema.
도구의 종류:
atlas- MongoDB Atlas 도구(클러스터 목록, 클러스터 생성 등)mongodb- 찾기, 집계 등의 MongoDB 데이터베이스 도구
작업 유형:
create- 클러스터 생성, 문서 삽입 등과 같이 리소스를 생성하는 도구입니다.update- 문서 업데이트, 컬렉션 이름 변경 등 리소스를 업데이트하는 도구입니다.delete- 문서 삭제, 컬렉션 삭제 등 리소스를 삭제하는 도구입니다.read- 찾기, 집계, 클러스터 나열 등과 같이 리소스를 읽는 도구입니다.metadata- 목록 데이터베이스, 목록 컬렉션, 컬렉션 스키마 등과 같은 메타데이터를 읽는 도구입니다.
읽기 전용 모드
readOnly 구성 옵션을 사용하면 MCP 서버가 "읽기" 및 "메타데이터" 작업 유형을 가진 도구만 사용하도록 제한할 수 있습니다. 이 옵션을 활성화하면 "생성", "업데이트" 또는 "삭제" 작업 유형을 가진 모든 도구가 서버에 등록되지 않습니다.
이 기능은 데이터나 인프라를 수정하지 않고도 분석을 위해 MongoDB 데이터에 대한 액세스를 제공하려는 경우에 유용합니다.
다음을 사용하여 읽기 전용 모드를 활성화할 수 있습니다.
환경 변수 :
export MDB_MCP_READ_ONLY=true명령줄 인수 :
--readOnly
읽기 전용 모드가 활성화되어 있으면 이 제한으로 인해 어떤 도구가 등록되지 않았는지 알려주는 메시지가 서버 로그에 표시됩니다.
원격 측정
telemetry 구성 옵션을 사용하면 원격 측정 데이터 수집을 비활성화할 수 있습니다. 활성화하면 MCP 서버가 사용 데이터를 수집하여 MongoDB로 전송합니다.
다음을 사용하여 원격 측정을 비활성화할 수 있습니다.
환경 변수 :
export MDB_MCP_TELEMETRY=disabled명령줄 인수 :
--telemetry disabledDO_NOT_TRACK 환경 변수 :
export DO_NOT_TRACK=1
Atlas API 액세스
Atlas API 도구를 사용하려면 MongoDB Atlas에 서비스 계정을 만들어야 합니다.
서비스 계정 만들기:
cloud.mongodb.com 에서 MongoDB Atlas에 로그인하세요.
액세스 관리자 > 조직 액세스로 이동합니다.
새로 추가 > 애플리케이션 > 서비스 계정을 클릭합니다.
서비스 계정의 이름, 설명 및 만료일을 입력하세요(예: "MCP, MCP 서버 액세스, 7일").
적절한 권한을 선택하세요(전체 액세스의 경우 조직 소유자 사용)
"만들기"를 클릭하세요
서비스 계정에 대해 자세히 알아보려면 MongoDB Atlas 문서를 확인하세요.
클라이언트 자격 증명 저장:
생성 후 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
중요: 클라이언트 비밀번호는 다시 표시되지 않으므로 즉시 복사하여 저장하세요.
액세스 목록 항목 추가:
API 액세스 목록에 IP 주소를 추가하세요
MCP 서버 구성:
아래 구성 방법 중 하나를 사용하여
apiClientId및apiClientSecret설정하세요.
구성 방법
환경 변수
대문자로 옵션 이름을 붙이고 MDB_MCP_ 접두사를 붙여 환경 변수를 설정합니다. 뒤에 밑줄을 붙입니다.
# Set Atlas API credentials (via Service Accounts)
export MDB_MCP_API_CLIENT_ID="your-atlas-service-accounts-client-id"
export MDB_MCP_API_CLIENT_SECRET="your-atlas-service-accounts-client-secret"
# Set a custom MongoDB connection string
export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
export MDB_MCP_LOG_PATH="/path/to/logs"
MCP 구성 파일 예제
환경 변수가 있는 연결 문자열
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server"],
"env": {
"MDB_MCP_CONNECTION_STRING": "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
}
}
}
}
환경 변수가 포함된 Atlas API 자격 증명
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server"],
"env": {
"MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id",
"MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret"
}
}
}
}
명령줄 인수
서버를 시작할 때 구성 옵션을 명령줄 인수로 전달합니다.
npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret" --connectionString="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" --logPath=/path/to/logs
MCP 구성 파일 예제
명령줄 인수가 있는 연결 문자열
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server",
"--connectionString",
"mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
]
}
}
}
명령줄 인수가 포함된 Atlas API 자격 증명
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server",
"--apiClientId",
"your-atlas-service-accounts-client-id",
"--apiClientSecret",
"your-atlas-service-accounts-client-secret"
]
}
}
}
🤝 기여하기
기여하고 싶으신가요? 좋습니다! 코드 기여, 표준, 새 도구 추가 및 문제 해결 정보에 대한 지침은 기여 가이드를 참조하세요.
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that enables AI models to interact with both MySQL and MongoDB databases through a standardized interface, supporting comprehensive database operations including queries, schema management, and CRUD operations.Last updated -146MIT License
- -security-license-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -361
- Asecurity-licenseAqualityA Model Context Protocol server implementation that enables AI assistants to interact with Apollo.io data, performing operations like people/organization enrichment, searching, and retrieving job postings through natural language commands.Last updated -727MIT License