MongoDB Atlas MCP 서버

MongoDB Atlas 프로젝트를 관리하기 위한 MCP(Model Context Protocol) 서버입니다. 이 패키지는 MCP 인터페이스를 통해 MongoDB Atlas 클러스터, 사용자 및 네트워크 액세스를 생성하고 관리하는 도구를 제공합니다.

데모 비디오

MongoDB Atlas MCP 서버가 어떻게 동작하는지 보려면 데모 비디오를 시청하세요.

특징

MCP 도구

create_atlas_cluster - 기존 프로젝트에 새로운 MongoDB Atlas 클러스터를 만듭니다.
setup_atlas_network_access - Atlas 프로젝트에 대한 네트워크 액세스 구성
create_atlas_user - atlasAdmin 역할로 새 데이터베이스 사용자를 만듭니다.
get_atlas_connection_strings - 클러스터에 대한 연결 문자열 검색
list_atlas_projects - 제공된 API 키로 접근 가능한 모든 Atlas 프로젝트 나열
list_atlas_clusters - 특정 Atlas 프로젝트의 모든 클러스터를 나열합니다.

설치

지엑스피1

용법

명령줄 도구로

명령줄에서 Atlas Project Manager를 직접 실행할 수 있습니다.

# Using environment variables
export ATLAS_PUBLIC_KEY="your-public-key"
export ATLAS_PRIVATE_KEY="your-private-key"
npx mcp-mongodb-atlas

# Or passing keys as arguments
npx mcp-mongodb-atlas "your-public-key" "your-private-key"

Cline(VSCode 확장 프로그램) 사용

VSCode에서 Cline을 사용하려면 MCP 설정 파일에 서버 구성을 추가하세요.

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

MCP 설정 파일은 다음 위치에 있습니다.

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
리눅스: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

커서 포함

커서와 함께 사용하려면 설정에서 "커서 설정" > "MCP"로 이동하여 다음 구성으로 새 서버를 추가하세요.

이름 : atlas (또는 원하는 이름)
명령어 : npx mcp-mongodb-atlas
인수 : API 키를 인수로 제공하세요

## Suggested Command
npx mcp-mongodb-atlas <public_key> <private_key>

최신 버전에서는 ~/.cursor/mcp.json 파일을 다음과 같이 설정할 수 있습니다.

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

환경 변수 (선택 사항):
- ATLAS_PUBLIC_KEY : MongoDB Atlas 공개 키
- ATLAS_PRIVATE_KEY : MongoDB Atlas 개인 키

Claude Desktop과 함께

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

API 키

이 도구를 사용하려면 MongoDB Atlas API 키가 필요합니다. API 키를 생성하려면 다음을 수행하세요.

MongoDB Atlas 계정에 로그인하세요
액세스 관리자 > API 키로 이동하세요.
적절한 권한으로 새 API 키를 만듭니다.
공개 키와 개인 키를 저장하세요

개발

저장소를 복제하고 종속성을 설치합니다.

git clone https://github.com/mongodb-developer/mcp-mongodb-atlas.git
cd mcp-mongodb-atlas
npm install

프로젝트를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 사용을 권장합니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

특허

MIT

MongoDB Atlas MCP Server

Integrations