Mongodb MCP

🚀 MongoDB MCP Server for LLM

A Model Context Protocol (MCP) server that enables LLMs to directly interact with MongoDB databases. You can query collections, check schemas, and manage data using natural language.

✨ Features

• 🔍 Check collection schemas
• 📊 Query and filter documents
• 📈 Manage indexes
• 📝 Perform 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 it to the Claude Desktop configuration 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://<username>:<password>@<host>:<port>/<database>?authSource=admin"
      ]
    }
  }
}

Installation via Smithery

To automatically install the MongoDB MCP server for Claude Desktop 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 (e.g., Claude Desktop App)

Test Sandbox Setup

If you don't have a MongoDB server available and want to create a sample sandbox, follow these steps:

1. Start MongoDB using Docker Compose:

docker-compose up -d

2. Populate the database with test data:

npm run seed

Configure Claude Desktop

Add this configuration to the Claude Desktop configuration 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 information (name, email, age)
• Nested address and its coordinates
• Array of interests
• Membership date

Content

• Document title
• Document content
• Creation date
• Update date

Orders

• Customer ID
• Order details
• Order status
• Order date

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.