MongoDB MCP 서버 설정 가이드
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
DevOps
대상자
AI 애플리케이션 개발자, MongoDB 사용자, VS Code 및 GitHub Copilot 활용자
난이도: 중급 (Node.js 환경 설정 및 MCP 프로토콜 이해 필요)
핵심 요약
- MCP 프로토콜은 AI 애플리케이션과 외부 도구 간 통합을 M + N 모델로 단순화하여 1 서버 당 1 도구, 1 클라이언트 당 1 애플리케이션 구조를 제공
- MongoDB MCP 서버 설정은
mcp.json
파일에 연결 문자열을 정의하고npm i mongodb-mcp-server
명령어로 실행 - GitHub Copilot 확장 프로그램 설치 후 자연어 명령으로 MongoDB 쿼리 생성 가능 (예: "Show me all users who signed up last week")
섹션별 세부 요약
1. MCP 프로토콜 개요
- MCP(Model Context Protocol): Anthropic이 제안한 AI 애플리케이션과 외부 도구 통합을 위한 표준 프로토콜
- M × N 통합 문제 해결: 기존 M개 AI 앱과 N개 도구 간 복잡한 통합을 1 서버/클라이언트당 1 인터페이스로 간소화
- 클라이언트-서버 아키텍처:
- Host: 사용자와 상호작용하는 AI 애플리케이션 (예: Claude, IDE)
- Client: 호스트 내부에서 MCP 서버와 1:1 연결 관리
- Server: 외부 프로그램으로 기능을 표준 API를 통해 제공
2. MongoDB MCP 서버 설정 단계
- 필수 조건: Node.js 20 이상 버전 사용 (명령어:
node -v
로 확인) - npm 설치:
npm i mongodb-mcp-server
명령어로 패키지 설치 - mcp.json 파일 생성:
.vscode
폴더 내mcp.json
파일에 MongoDB 연결 문자열 정의
```json
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server", "--connectionString", "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"]
}
}
}
```
- 서버 실행:
mcp.json
파일에서 Start 버튼 클릭 후 서버 실행
3. GitHub Copilot 통합
- 확장 프로그램 설치: VS Code Marketplace에서 GitHub Copilot 및 GitHub Copilot Chat 설치
- 인증: GitHub 계정으로 로그인 후 Copilot 기능 활성화
- Agent Mode 활성화: 자연어로 MongoDB에 명령 입력 (예: "Add a new user with the username TestUser7")
- 자동 쿼리 생성: 입력된 자연어 명령을 MongoDB 쿼리로 자동 변환 및 실행
결론
- MCP 프로토콜 활용으로 AI 애플리케이션과 외부 도구 간 통합의 복잡성을 줄이고 모듈화된 생태계 구축 가능
- VS Code + GitHub Copilot을 통해 자연어로 MongoDB 데이터 조작 가능 (실무에서 빠른 프로토타입 개발에 유리)
- 보안 주의: MongoDB 연결 문자열에서
username:password
필드는 실제 값으로 대체해야 하며, 민감 정보는 암호화하여 저장해야 함