Mongodb Model Context Protocol MCP

🚀 MongoDB Model Context Protocol (MCP) Server for LLM

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

🚀 Quick Start

To get started, find your MongoDB connection URL and add the following configuration to your Claude Desktop configuration file:

MacOS: ~/Library/Application\ 支持/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

Automatically install the MongoDB MCP Server for Claude Desktop through 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 database 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. Run the seed script to create test data:

npm run seed

Configure Claude Desktop

Modify the configuration file on different operating systems:

MacOS and Linux:
Edit the ~/.config/Claude/claude_config.json file and add the following content:

"mongo-mcp": {
  " connectionString": "mongodb://localhost:27017"
}

Windows:
Edit the %APPDATA%/Claude/claude_config.json file and add similar content.

✨ 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

💻 Usage Examples

Basic Usage

# Query all documents
/mongo-mcp --query '{"command": "findAll"}'

# Insert a new document
/mongo-mcp --insert '{"name": "test", "value": 123}'

Advanced Usage

# Find by criteria
/mongo-mcp --search '{"name": "test"}' --projection '{"_id": 0, "name": 1}'

# Update a document
/mongo-mcp --update '{"query": {"name": "test"}, "update": {"$set": {"value": 456}}}'

Index Management

# Create an index
/mongo-mcp --create-index '{"collection": "users", "index": { "field": 1 }}'

# Drop an index
/mongo-mcp --drop-index '{"collection": "users", "indexName": "field_1"}'

Available Tools

Query Tools

• find: Find all documents
• search: Find by criteria
• insert: Insert a new document
• update: Update an existing document
• delete: Delete a document

Index Tools

• create-index: Create an index
• drop-index: Drop an index
• indexes: List indexes of a collection

📄 License

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