MongoDB MCP Server for LLMS
A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.
Features
- Collection schema inspection
- Document querying and filtering
- Index management
- Document operations (insert, update, delete)
Demo Video
Quick Start
To get started, find your mongodb connection url and add this configuration to your Claude Desktop config file:
MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%/Claude/claude_desktop_config.jsonInstalling via Smithery
To install MongoDB MCP Server for Claude Desktop automatically via Smithery:
Prerequisites
- Node.js 18+
- npx
- Docker and Docker Compose (for local sandbox testing only)
- MCP Client (Claude Desktop App for example)
Test Sandbox Setup
If you don't have a mongo db server to connect to and want to create a sample sandbox, follow these steps
- Start MongoDB using Docker Compose:
- Seed the database with test data:
Configure Claude Desktop
Add this configuration to your Claude Desktop config file:
MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%/Claude/claude_desktop_config.jsonLocal Development Mode:
Test Sandbox Data Structure
The seed script creates three collections with sample data:
Users
- Personal info (name, email, age)
- Nested address with coordinates
- Arrays of interests
- Membership dates
Products
- Product details (name, SKU, category)
- Nested specifications
- Price and inventory info
- Tags and ratings
Orders
- Order details with items
- User references
- Shipping and payment info
- Status tracking
Example Prompts
Try these prompts with Claude to explore the functionality:
Basic Operations
Advanced Queries
Index Management
Document Operations
Available Tools
The server provides these tools for database interaction:
Query Tools
find: Query documents with filtering and projection
listCollections: List available collections
insertOne: Insert a single document
updateOne: Update a single document
deleteOne: Delete a single document
Index Tools
createIndex: Create a new index
dropIndex: Remove an index
indexes: List indexes for a collection
License
This project is licensed under the MIT License - see the LICENSE file for details.
MongoDB MCP Server for LLMS
A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.
Features
- Collection schema inspection
- Document querying and filtering
- Index management
- Document operations (insert, update, delete)
Demo Video
Quick Start
To get started, find your mongodb connection url and add this configuration to your Claude Desktop config file:
MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%/Claude/claude_desktop_config.jsonInstalling via Smithery
To install MongoDB MCP Server for Claude Desktop automatically via Smithery:
Prerequisites
- Node.js 18+
- npx
- Docker and Docker Compose (for local sandbox testing only)
- MCP Client (Claude Desktop App for example)
Test Sandbox Setup
If you don't have a mongo db server to connect to and want to create a sample sandbox, follow these steps
- Start MongoDB using Docker Compose:
- Seed the database with test data:
Configure Claude Desktop
Add this configuration to your Claude Desktop config file:
MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%/Claude/claude_desktop_config.jsonLocal Development Mode:
Test Sandbox Data Structure
The seed script creates three collections with sample data:
Users
- Personal info (name, email, age)
- Nested address with coordinates
- Arrays of interests
- Membership dates
Products
- Product details (name, SKU, category)
- Nested specifications
- Price and inventory info
- Tags and ratings
Orders
- Order details with items
- User references
- Shipping and payment info
- Status tracking
Example Prompts
Try these prompts with Claude to explore the functionality:
Basic Operations
Advanced Queries
Index Management
Document Operations
Available Tools
The server provides these tools for database interaction:
Query Tools
find: Query documents with filtering and projection
listCollections: List available collections
insertOne: Insert a single document
updateOne: Update a single document
deleteOne: Delete a single document
Index Tools
createIndex: Create a new index
dropIndex: Remove an index
indexes: List indexes for a collection
License
This project is licensed under the MIT License - see the LICENSE file for details.