Mongodb Developer Mongodb MCP Server

🚀 MongoDB MCP Server

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

🚀 Quick Start

The MongoDB MCP Server offers read - only access to MongoDB databases, allowing LLMs to interact with the data effectively.

✨ Features

Tools

• aggregate

  • Execute MongoDB aggregation pipeline operations.
  • Inputs:
    • collection (string): The name of the collection to query.
    • pipeline (array): MongoDB aggregation pipeline stages.
    • options (object): Optional aggregation settings.
      • allowDiskUse (boolean): Allow disk operations.
      • maxTimeMS (number): Maximum execution time in milliseconds.
      • comment (string): A comment to identify the operation.
  • By default, if no limit stage is specified, the default limit is 1000 documents.
  • The default timeout is 30 seconds.

• explain

  • Get the execution plan of an aggregation pipeline.
  • Inputs:
    • collection (string): The name of the collection to analyze.
    • pipeline (array): MongoDB aggregation pipeline stages.
    • verbosity (string): The level of detail for the explanation.
      • Optional values: "queryPlanner", "executionStats", "allPlansExecution".
      • Default value: "queryPlanner".

Resources

The server provides schema information for each collection:

• Collection Schema (mongodb://<host>/<collection>/schema)
  • JSON schema information derived from a sample of collection documents.
  • Includes field names and data types.
  • The schema is derived from a sample of collection documents.

📚 Documentation

Configuration with Claude Desktop

To use this server in the Claude Desktop application, add the following configuration to the "mcpServers" section of the claude_desktop_config.json file:

"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.

💻 Usage Examples

Basic Usage

{
  "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"
  }
}

Advanced Usage

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

🔧 Technical Details

Security Features

• By default, if no limit is specified in the pipeline, the default limit is 1000 documents.
• The default timeout is 30 seconds.
• Read-only operations.
• Safe schema inference from collection samples.

📄 License

This MCP server is released 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, see the LICENSE file in the project repository.