MCP MongoDB Server logo

MCP MongoDB Server

by kiliczsh

The MCP MongoDB Server enables LLMs to interact with MongoDB databases by providing capabilities for inspecting collection schemas and executing MongoDB operations through a standardized interface. It facilitates seamless integration between LLMs and MongoDB for enhanced data access and manipulation.

View on GitHub

Last updated: N/A

What is MCP MongoDB Server?

The MCP MongoDB Server is a Model Context Protocol server designed to allow Large Language Models (LLMs) to interact with MongoDB databases. It provides a standardized interface for LLMs to inspect collection schemas and execute MongoDB operations.

How to use MCP MongoDB Server?

To use the server, install it globally using npm install -g mcp-mongo-server. Then, start the server with the MongoDB URI using npx -y mcp-mongo-server mongodb://<user>:<password>@<host>:<port>/<database>. You can also configure the server using environment variables like MCP_MONGODB_URI and MCP_MONGODB_READONLY. Integrate it with tools like Claude Desktop, Windsurf, and Cursor by adding the server configuration to their respective config files.

Key features of MCP MongoDB Server

  • Smart ObjectId Handling

  • Flexible Configuration (Environment Variables and Command-line Options)

  • Read-Only Mode for safe production database connections

  • MongoDB Operations (Read and Write)

  • LLM Integration (Collection completions, Schema inference, Collection analysis)

Use cases of MCP MongoDB Server

  • Enabling LLMs to query and analyze data stored in MongoDB

  • Allowing LLMs to update or insert data into MongoDB (when not in read-only mode)

  • Providing LLMs with schema information to improve context understanding

  • Integrating MongoDB data access into LLM-powered applications and workflows

FAQ from MCP MongoDB Server

What is ObjectId handling?

The server intelligently converts between string IDs and MongoDB ObjectId, configurable with the objectIdMode parameter.

How do I enable read-only mode?

Set the MCP_MONGODB_READONLY environment variable to "true" or use the --read-only command-line option.

What read operations are supported?

The server supports querying documents, executing aggregation pipelines, counting documents, and getting collection schema information.

What write operations are supported?

When not in read-only mode, the server supports updating documents, inserting new documents, and creating indexes.

How can I debug the server?

Use the MCP Inspector by running npm run inspector to access debugging tools in your browser.