Overview
What is MCP MongoDB Server?
MCP MongoDB Server is a Model Context Protocol server that enables LLMs to interact with MongoDB databases. It provides capabilities for inspecting collection schemas and executing MongoDB operations through a standardized interface.
How to use MCP MongoDB Server?
Start the server via npx with a MongoDB URI: npx -y mcp-mongo-server mongodb://localhost:27017/database. Use the --read-only flag to prevent write operations. Alternatively, set the MCP_MONGODB_URI and MCP_MONGODB_READONLY environment variables.
Key features of MCP MongoDB Server
- Smart ObjectId Handling with configurable auto/none/force modes.
- Read-Only Mode for protection against write operations.
- Schema Inference from document samples.
- Query & Aggregation with full MongoDB pipeline support.
- Write Operations including insert, update, and index creation.
- Collection Completions for auto-complete collection names.
Use cases of MCP MongoDB Server
- Allow LLMs to query MongoDB databases interactively.
- Inspect collection schemas automatically.
- Execute aggregation pipelines with explain plans.
- Perform write operations when not in read-only mode.
FAQ from MCP MongoDB Server
How do I connect to MongoDB?
Pass the MongoDB URI as a command-line argument, e.g., npx -y mcp-mongo-server mongodb://localhost:27017/database, or set the MCP_MONGODB_URI environment variable.
Can I prevent write operations?
Yes, use the --read-only flag or set MCP_MONGODB_READONLY to "true". Read-only mode also uses secondary read preference.
What tools are available?
The server provides tools for query, aggregate, update, insert, and more. See the Available Tools documentation.
How does ObjectId handling work?
ObjectId handling has three configurable modes: auto, none, and force for string-to-ObjectId conversion.
Is there a license?
Yes, MCP MongoDB Server is released under the MIT license.
