🗄️ MongoDB MCP Server for LLMS

Permalink: 🗄️ 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

Permalink: ✨ Features

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

Demo Video

Permalink: Demo Video

mongo-mcp-demo-gh.mp4

🚀 Quick Start

Permalink: 🚀 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://<username>:<password>@<host>:<port>/<database>?authSource=admin"\
      ]
    }
  }
}

Installing via Smithery

Permalink: Installing via Smithery

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

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

Prerequisites

Permalink: Prerequisites

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

Test Sandbox Setup

Permalink: 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

Start MongoDB using Docker Compose:

docker-compose up -d

Seed the database with test data:

npm run seed

Configure Claude Desktop

Permalink: 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:

Permalink: Local Development Mode:

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

Test Sandbox Data Structure

Permalink: Test Sandbox Data Structure

The seed script creates three collections with sample data:

Users

Permalink: Users

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

Products

Permalink: Products

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

Orders

Permalink: Orders

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

🎯 Example Prompts

Permalink: 🎯 Example Prompts

Try these prompts with Claude to explore the functionality:

Basic Operations

Permalink: Basic Operations

"What collections are available in the database?"
"Show me the schema for the users collection"
"Find all users in San Francisco"

Advanced Queries

Permalink: Advanced Queries

"Find all electronics products that are in stock and cost less than $1000"
"Show me all orders from the user john@example.com"
"List the products with ratings above 4.5"

Index Management

Permalink: Index Management

"What indexes exist on the users collection?"
"Create an index on the products collection for the 'category' field"
"List all indexes across all collections"

Document Operations

Permalink: Document Operations

"Insert a new product with name 'Gaming Laptop' in the products collection"
"Update the status of order with ID X to 'shipped'"
"Find and delete all products that are out of stock"

📝 Available Tools

Permalink: 📝 Available Tools

The server provides these tools for database interaction:

Query Tools

Permalink: Query Tools

find: Query documents with filtering and projection
listCollections: List available collections
insertOne: Insert a single document
updateOne: Update a single document
deleteOne: Delete a single document

Index Tools

Permalink: Index Tools

createIndex: Create a new index
dropIndex: Remove an index
indexes: List indexes for a collection

📜 License

Permalink: 📜 License

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

About

A mongo db server for the model context protocol (MCP)

Releases

No releases published

Packages\ 0

No packages published

QuantGeekDev/mongo-mcp

Installation

Claude Desktop

Installation Command

Configuration

Instructions

README