mongodb3-mcp-server

A lightweight MCP (Model Context Protocol) server for MongoDB, compatible with MongoDB 3.6.18+.

Uses mongodb driver v4.x which officially supports MongoDB 3.6+.

Quick Start

# Install dependencies
npm install

# Build
npm run build

# Run (stdio transport)
MDB_MCP_CONNECTION_STRING="mongodb://localhost:27017" node dist/index.js

MCP Client Configuration

{
  "mcpServers": {
    "MongoDB": {
      "command": "node",
      "args": ["/path/to/mongodb3-mcp-server/dist/index.js"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017"
      }
    }
  }
}

Enable Write Mode

By default, the server runs in read-only mode for safety. To enable write/delete operations:

{
  "mcpServers": {
    "MongoDB": {
      "command": "node",
      "args": ["/path/to/mongodb3-mcp-server/dist/index.js"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017",
        "MDB_MCP_WRITABLE": "true"
      }
    }
  }
}

Pass --writable CLI flag as an alternative.

Kiro MCP Configuration

Add the following to your Kiro MCP config (~/.kiro/settings/mcp.json):

{
  "mcpServers": {
    "dev-mongodb3": {
      "command": "npx",
      "args": ["mongodb3-mcp-server"],
      "env": {
        "MDB_MCP_WRITABLE": "false",
        "MDB_MCP_CONNECTION_STRING": "mongodb://root:root@localhost:17017/admin?authSource=admin"
      },
      "disabled": true
    }
  }
}

Configuration

Supported Tools (23 tools)

Connection (2)

Read (5)

Metadata (7)

Write (requires --writable or MDB_MCP_WRITABLE=true) (3)

Manage (requires --writable or MDB_MCP_WRITABLE=true) (6)

Resources

MongoDB 3.6 Compatibility

This server uses mongodb driver v4.17.x which officially supports MongoDB 3.6+. All tools use commands and operations available in MongoDB 3.6:

• find, aggregate, count — core query operations
• $sample aggregation stage for schema inference
• collStats, dbStats, getLog admin commands
• createIndexes, dropIndexes index management
• listDatabases, listCollections metadata commands
• insert, update, delete write operations

No features requiring MongoDB 4.0+ (like transactions or $merge) are used.