MCP MongoDB Server

Name: MCP MongoDB Server
Author: kiliczsh

@kiliczsh

Repository Homepage

About MCP MongoDB Server

A Model Context Protocol Server for MongoDB

#mongo #mongodb #mcp #cursor #cline #claude #windsurf #claude-desktop #model-context-protocol #antrophic

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "github:kiliczsh/mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    },
    "mongodb-readonly": {
      "command": "npx",
      "args": [
        "-y",
        "github:kiliczsh/mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database",
        "--read-only"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP MongoDB Server?

MCP MongoDB Server is a Model Context Protocol server that enables LLMs to interact with MongoDB databases. It provides capabilities for inspecting collection schemas and executing MongoDB operations through a standardized interface.

How to use MCP MongoDB Server?

Start the server via npx with a MongoDB URI: npx -y mcp-mongo-server mongodb://localhost:27017/database. Use the --read-only flag to prevent write operations. Alternatively, set the MCP_MONGODB_URI and MCP_MONGODB_READONLY environment variables.

Key features of MCP MongoDB Server

Smart ObjectId Handling with configurable auto/none/force modes.
Read-Only Mode for protection against write operations.
Schema Inference from document samples.
Query & Aggregation with full MongoDB pipeline support.
Write Operations including insert, update, and index creation.
Collection Completions for auto-complete collection names.

Use cases of MCP MongoDB Server

Allow LLMs to query MongoDB databases interactively.
Inspect collection schemas automatically.
Execute aggregation pipelines with explain plans.
Perform write operations when not in read-only mode.

FAQ from MCP MongoDB Server

How do I connect to MongoDB?

Pass the MongoDB URI as a command-line argument, e.g., npx -y mcp-mongo-server mongodb://localhost:27017/database, or set the MCP_MONGODB_URI environment variable.