MCP MongoDB Server

NPM Version NPM Downloads NPM License

A Model Context Protocol server that enables LLMs to interact with MongoDB databases. This server provides capabilities for inspecting collection schemas and executing MongoDB operations through a standardized interface.

Demo

Key Features

Smart ObjectId Handling - Configurable auto/none/force modes for string-to-ObjectId conversion
Read-Only Mode - Protection against write operations, uses secondary read preference
Schema Inference - Automatic collection schema detection from document samples
Query & Aggregation - Full MongoDB query and aggregation pipeline support with optional explain plans
Write Operations - Insert, update, and index creation (when not in read-only mode)
Collection Completions - Auto-complete collection names for LLM integration

Installation

npx -y mcp-mongo-server mongodb://localhost:27017/database

Usage

# Start server with MongoDB URI
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database

# Connect in read-only mode
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database --read-only

Environment Variables

Variable	Description
`MCP_MONGODB_URI`	MongoDB connection URI
`MCP_MONGODB_READONLY`	Enable read-only mode (`"true"`)

Documentation

Integration Guide - Claude Desktop, Windsurf, Cursor, Docker
Available Tools - Query, aggregate, update, insert, and more
Development - Setup, scripts, and debugging
Contributing

License

MIT - see LICENSE for details.

Install