loading…
en/
Browse all
kiliczsh/mcp-mongo-server
FreeA Model Context Protocol Server for MongoDB
About
A Model Context Protocol Server for MongoDB
README
A Model Context Protocol server that enables LLMs to interact with MongoDB databases. This server provides capabilities for inspecting collection schemas and executing MongoDB operations through a standardized interface.
Demo
MCP MongoDB Server Demo | Claude Desktop
Key Features
- Smart ObjectId Handling - Configurable auto/none/force modes for string-to-ObjectId conversion
- Read-Only Mode - Protection against write operations, uses secondary read preference
- Schema Inference - Automatic collection schema detection from document samples
- Query & Aggregation - Full MongoDB query and aggregation pipeline support with optional explain plans
- Write Operations - Insert, update, and index creation (when not in read-only mode)
- Collection Completions - Auto-complete collection names for LLM integration
Installation
npx -y mcp-mongo-server mongodb://localhost:27017/database
Usage
# Start server with MongoDB URI
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database
# Connect in read-only mode
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database --read-only
Environment Variables
| Variable | Description |
|---|---|
MCP_MONGODB_URI |
MongoDB connection URI |
MCP_MONGODB_READONLY |
Enable read-only mode ("true") |
Documentation
- Integration Guide - Claude Desktop, Windsurf, Cursor, Docker
- Available Tools - Query, aggregate, update, insert, and more
- Development - Setup, scripts, and debugging
- Contributing
License
MIT - see LICENSE for details.
Install kiliczsh/mcp-mongo-server in Claude Desktop, Claude Code & Cursor
Run in your terminal:
claude mcp add kiliczsh-mcp-mongo-server -- npx FAQ
Is kiliczsh/mcp-mongo-server MCP free?
Yes, kiliczsh/mcp-mongo-server MCP is free — one-click install via Unyly at no cost.
Does kiliczsh/mcp-mongo-server need an API key?
No, kiliczsh/mcp-mongo-server runs without API keys or environment variables.
Is kiliczsh/mcp-mongo-server hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install kiliczsh/mcp-mongo-server in Claude Desktop, Claude Code or Cursor?
Open kiliczsh/mcp-mongo-server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
