LLM이 MongoDB 데이터베이스와 직접 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 컬렉션을 쿼리하고, 스키마를 검사하며, 자연어를 통해 데이터를 원활하게 관리할 수 있습니다.

✨ 특징

• 🔍 컬렉션 스키마 검사
• 📊 문서 쿼리 및 필터링
• 📈 인덱스 관리
• 📝 문서 작업 (삽입, 업데이트, 삭제)

데모 비디오

https://github.com/user-attachments/assets/2389bf23-a10d-49f9-bca9-2b39a1ebe654

🚀 퀵 스타트

시작하려면 Mongodb 연결 URL을 찾아 이 설정을 Claude Desktop 설정 파일에 추가하세요:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json 윈도우: %APPDATA%/Claude/claude_desktop_config.json

Smithery를 통해 설치 중

Smithery를 통해 Claude Desktop용 MongoDB MCP 서버를 자동으로 설치하려면:

전제 조건

• Node.js 18+
• NPX
• Docker 및 Docker Compose (로컬 샌드박스 테스트용)
• MCP 클라이언트 (예: Claude 데스크톱 앱)

테스트 샌드박스 설정

만약 연결할 Mongo DB 서버가 없고 샘플 샌드박스를 만들고 싶다면, 다음 단계를 따르세요

1. Docker Compose를 사용하여 MongoDB 시작:

2. 데이터베이스에 테스트 데이터를 시딩하기:

🗄️ MongoDB MCP Server for LLMS

A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.

✨ Features

• 🔍 Collection schema inspection
• 📊 Document querying and filtering
• 📈 Index management
• 📝 Document operations (insert, update, delete)

Demo Video

https://github.com/user-attachments/assets/2389bf23-a10d-49f9-bca9-2b39a1ebe654

🚀 Quick Start

To get started, find your mongodb connection url and add this configuration to your Claude Desktop config file:

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

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "mongo-mcp",
        "mongodb://:@:/?authSource=admin"
      ]
    }
  }
}

Installing via Smithery

To install MongoDB MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mongo-mcp --client claude

Prerequisites

• Node.js 18+
• npx
• Docker and Docker Compose (for local sandbox testing only)
• MCP Client (Claude Desktop App for example)

Test Sandbox Setup

If you don’t have a mongo db server to connect to and want to create a sample sandbox, follow these steps

1. Start MongoDB using Docker Compose:

docker-compose up -d

2. Seed the database with test data:

npm run seed

Configure Claude Desktop

Add this configuration to your Claude Desktop config file:

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

Local Development Mode:

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": [
        "dist/index.js",
        "mongodb://root:example@localhost:27017/test?authSource=admin"
      ]
    }
  }
}

Test Sandbox Data Structure

The seed script creates three collections with sample data:

Users

• Personal info (name, email, age)
• Nested address with coordinates
• Arrays of interests
• Membership dates

Products

• Product details (name, SKU, category)
• Nested specifications
• Price and inventory info
• Tags and ratings

Orders

• Order details with items
• User references
• Shipping and payment info
• Status tracking

🎯 Example Prompts

Try these prompts with Claude to explore the functionality:

Basic Operations

"What collections are available in the database?"