An MCP server that enables LLMs to interact with MongoDB databases, providing capabilities for analyzing collection schemas and executing MongoDB operations through a standardized interface.

Installation

NPX

npm install -g mcp-mongo-server

From Source

git clone https://github.com/kiliczsh/mcp-mongo-server.git
cd mcp-mongo-server
npm install
npm run build

Docker

docker build -t mcp-mongo-server .
docker run -it -d -e MCP_MONGODB_URI="mongodb://muhammed:kilic@localhost:27017/database" -e MCP_MONGODB_READONLY="true" mcp-mongo-server

Smithery

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

mcp-get

npx @michaellatman/mcp-get@latest install mcp-mongo-server

Configuration

Claude Desktop - Command Arguments

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    }
  }
}

Claude Desktop - Environment Variables

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server"
      ],
      "env": {
        "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database"
      }
    }
  }
}

Windsurf Configuration

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    }
  }
}

Cursor Configuration

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    }
  }
}

Available Tools

Tool	Description
query	Execute MongoDB queries with optional execution plan analysis
aggregate	Run aggregation pipelines with optional query planning
count	Count documents matching criteria
update	Modify documents in collections
insert	Add new documents to collections
createIndex	Create collection indexes
serverInfo	Retrieve MongoDB server details and debugging information

Features

• Intelligent ObjectId handling with customizable conversion modes
• Read-only mode for safe production database access
• Collection schema analysis and output
• Execution plan analysis for query optimization
• Aggregation pipeline support
• Index creation and management
• Collection autocompletion for improved LLM interaction
• Flexible configuration via environment variables or command-line options
• Secondary read preference for optimal performance in read-only mode

Environment Variables

Optional

• MCP_MONGODB_URI - MongoDB connection URI
• MCP_MONGODB_READONLY - Enables read-only mode when set to 'true'

Usage Examples

Find all users over 30 with their names and email

Count all electronic items in inventory

Get total sales by customers using aggregation

Update a post title by ID

Insert new comments into the comments collection

Notes

Supports multiple ObjectId conversion modes (auto, none, force). Use MCP Inspector for debugging with 'npm run inspector'. Includes evaluation support with the mcp-eval package. Compatible with Claude Desktop, Windsurf, and Cursor editors.