mongodb-mcp

MongoDB MCP Server

This MongoDB MCP server enables AI assistants to directly query and analyze MongoDB databases without write access, maintaining data safety while providing powerful data exploration capabilities.

Features

MongoDB Operations

• Database Exploration: List databases and collections
• Schema Discovery: Infer collection schemas from sample documents
• Querying: Execute MongoDB queries with filtering, projection, sorting, and limiting
• Aggregation: Run read-only aggregation pipelines with safety validation
• Text Search: Perform full-text search on collections with text indexes
• Geospatial Queries: Find locations near points, within polygons, or intersecting geometries
• Document Operations: Count documents, sample random documents, find documents by IDs
• Data Analysis: Get collection statistics, index information, and query execution plans
• Performance Insights: Examine query execution plans to optimize performance
• Data Exploration: Get distinct values, field distributions, and data samples
• Format Conversion: Export query results as JSON or CSV formats

Enhanced Capabilities

• Schema Inference: Automatically detect data types and structure from documents
• Visualization Hints: Intelligent suggestions for data visualization based on result content
• Safety Validation: Prevents write operations in aggregation pipelines
• Example-Rich Documentation: Each tool includes detailed examples in its description

Requirements

Environment Variables

• MONGODB_URI (required): MongoDB connection string with authentication if needed
• MONGODB_DEFAULT_DATABASE (optional): Default database name when not specified in queries

Prerequisites

• Network access to MongoDB server
• Authentication credentials if required by MongoDB instance
• Appropriate read permissions on target databases

Installation

Building from Source

Install dependencies: