MongoDB MCP Server

A Model Context Protocol server that provides read-only access to MongoDB databases. This server enables LLMs to inspect collection schemas and execute aggregation pipelines.

Components

Tools

aggregate
- Execute MongoDB aggregation pipelines against the connected database
- Input:
  - collection (string): The collection to query
  - pipeline (array): MongoDB aggregation pipeline stages
  - options (object): Optional aggregation settings
    - allowDiskUse (boolean): Allow operations that require disk usage
    - maxTimeMS (number): Maximum execution time in milliseconds
    - comment (string): Comment to identify the operation
- Default limit of 1000 documents if no limit stage is specified
- Default timeout of 30 seconds
explain
- Get execution plans for aggregation pipelines
- Input:
  - collection (string): The collection to analyze
  - pipeline (array): MongoDB aggregation pipeline stages
  - verbosity (string): Detail level of the explanation
    - Options: "queryPlanner", "executionStats", "allPlansExecution"
    - Default: "queryPlanner"

Resources

The server provides schema information for each collection in the database:

Collection Schemas (mongodb://<host>/<collection>/schema)
- Inferred JSON schema information for each collection
- Includes field names and data types
- Schema is derived from sampling collection documents

Usage with Claude Desktop

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

"mongodb": {
      "command": "npx",
      "args": [
        "-y" ,
        "@pash1986/mcp-server-mongodb"
      ],
     "env" : {
	"MONGODB_URI" : "mongodb+srv://<yourcluster>" // 'mongodb://localhost:27017'
	}
    }

Replace mydb with your database name and adjust the connection string as needed.

Example Usage

Basic Aggregation

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$group": {
      "_id": "$city",
      "avgAge": { "$avg": "$age" },
      "count": { "$sum": 1 }
    }},
    { "$sort": { "count": -1 } },
    { "$limit": 10 }
  ],
  "options": {
    "allowDiskUse": true,
    "maxTimeMS": 60000,
    "comment": "City-wise user statistics"
  }
}

Query Explanation

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$sort": { "age": 1 } }
  ],
  "verbosity": "executionStats"
}

Safety Features

Automatic limit of 1000 documents if no limit is specified in the pipeline
Default timeout of 30 seconds for all operations
Read-only operations only
Safe schema inference from collection samples

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides read-only access to MongoDB databases for LLMs to inspect collection schemas and execute aggregation pipelines.

Related Resources

Reddit Discussion about this server

Related MCP Servers

PostgreSQL MCP Server
vinsidious
-
security
F
license
-
quality
Provides read-only access to PostgreSQL databases, enabling users to inspect database schemas and execute read-only queries through a Model Context Protocol server.
Last updated -
4
JavaScript
MCP MySQL Server
yuru-sha
-
security
A
license
-
quality
Enables LLMs to interact with MySQL databases by inspecting schemas and executing safe, read-only queries within transactions.
Last updated -
2
8
JavaScript
MIT License
PostgreSQL MCP Server
DanielRSnell
-
security
F
license
-
quality
Provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only SQL queries within a secure transaction context.
Last updated -
21,111
1
JavaScript
PostgreSQL MCP Server
hsinyuyen
-
security
F
license
-
quality
Provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only SQL queries.
Last updated -
21,111
JavaScript

View all related MCP servers

MongoDB MCP Server