Community Data

MongoDB

Query, modify, and administer MongoDB databases — full driver surface.

279 stars 55 forks Last commit 4mo ago Language TypeScript License MIT
Sign in to like, install, or save to a bundle → View on GitHub →

Install

npm install -g mcp-mongo-server

Maintainer? Add the badge

Listed on Prismix ← shows on your README, links back here
[![Listed on Prismix](https://prismix.dev/api/badge/mcp/mongodb.svg)](https://prismix.dev/mcp/mongodb)

About

MongoDB Node-driver wrapper. Database + collection listing, document CRUD, aggregation pipelines, index management. Connection-string config like the Postgres server.

Recent releases (5)

All releases →
  • 2.0.2 Latest Feb 6, 2026
    ## 2.0.2                                                                                                                                                                                                                             
                                                                                                                                                                                                                                             
     ### Breaking Changes
    
     - Dockerfile completely rewritten — now uses multi-stage `oven/bun` + `node:22-slim` build instead of `debian:bullseye-slim` with `mcp-proxy`
     - Removed `mcp-proxy` dependency — HTTP transport is now native
     - `docker-compose.yml` no longer uses `tty`/`stdin_open` (HTTP mode by default)
    
     ### Features
    
     - **Streamable HTTP transport**: `--transport http` flag starts an Express server with MCP Streamable HTTP at `/mcp`
     - **Port configuration**: `--port` flag and `MCP_PORT` env var (default: `3001`)
     - **Request logging**: HTTP mode logs every request with timestamp, client IP, method, status, duration, and MCP method
     - **Docker healthcheck**: built-in health monitoring via `/mcp` endpoint
     - **Docker logging**: `json-file` driver with rotation (10MB x 3 files)
    
     ### Improvements
    
     - Multi-stage Docker build — smaller image, no git clone, copies local files
     - `tsup` externals: `@modelcontextprotocol/sdk` and `mongodb` kept as runtime imports
     - `.dockerignore` added to reduce build context
     - CI workflows switched from npm to bun, Node 20 to 22
     - Docs reorganized to reference example files
    
    **Full Changelog**: https://github.com/kiliczsh/mcp-mongo-server/compare/1.3.0...2.0.2
    View on GitHub ↗
  • 2.0.1 Feb 6, 2026
    ## 2.0.1                                                                                                                                                                                                                             
                                                                                                                                                                                                                                             
     ### Breaking Changes
    
     - Dockerfile completely rewritten — now uses multi-stage `oven/bun` + `node:22-slim` build instead of `debian:bullseye-slim` with `mcp-proxy`
     - Removed `mcp-proxy` dependency — HTTP transport is now native
     - `docker-compose.yml` no longer uses `tty`/`stdin_open` (HTTP mode by default)
    
     ### Features
    
     - **Streamable HTTP transport**: `--transport http` flag starts an Express server with MCP Streamable HTTP at `/mcp`
     - **Port configuration**: `--port` flag and `MCP_PORT` env var (default: `3001`)
     - **Request logging**: HTTP mode logs every request with timestamp, client IP, method, status, duration, and MCP method
     - **Docker healthcheck**: built-in health monitoring via `/mcp` endpoint
     - **Docker logging**: `json-file` driver with rotation (10MB x 3 files)
    
     ### Improvements
    
     - Multi-stage Docker build — smaller image, no git clone, copies local files
     - `tsup` externals: `@modelcontextprotocol/sdk` and `mongodb` kept as runtime imports
     - `.dockerignore` added to reduce build context
     - CI workflows switched from npm to bun, Node 20 to 22
     - Docs reorganized to reference example files
    
    **Full Changelog**: https://github.com/kiliczsh/mcp-mongo-server/compare/1.3.0...2.0.1
    View on GitHub ↗
  • 2.0.0 Feb 6, 2026
    ## 2.0.0                                                                                                                                                                                                                              
                                                                                                                                                                                                                                             
     ### Breaking Changes
    
     - Dockerfile completely rewritten — now uses multi-stage `oven/bun` + `node:22-slim` build instead of `debian:bullseye-slim` with `mcp-proxy`
     - Removed `mcp-proxy` dependency — HTTP transport is now native
     - `docker-compose.yml` no longer uses `tty`/`stdin_open` (HTTP mode by default)
    
     ### Features
    
     - **Streamable HTTP transport**: `--transport http` flag starts an Express server with MCP Streamable HTTP at `/mcp`
     - **Port configuration**: `--port` flag and `MCP_PORT` env var (default: `3001`)
     - **Request logging**: HTTP mode logs every request with timestamp, client IP, method, status, duration, and MCP method
     - **Docker healthcheck**: built-in health monitoring via `/mcp` endpoint
     - **Docker logging**: `json-file` driver with rotation (10MB x 3 files)
    
     ### Improvements
    
     - Multi-stage Docker build — smaller image, no git clone, copies local files
     - `tsup` externals: `@modelcontextprotocol/sdk` and `mongodb` kept as runtime imports
     - `.dockerignore` added to reduce build context
     - CI workflows switched from npm to bun, Node 20 to 22
     - Docs reorganized to reference example files
    
    **Full Changelog**: https://github.com/kiliczsh/mcp-mongo-server/compare/1.3.0...2.0.0
    View on GitHub ↗
  • 1.3.0 Apr 26, 2025
    ## What's Changed
    * feat: implement read-only mode for MongoDB connections by @kiliczsh in https://github.com/kiliczsh/mcp-mongo-server/pull/11
    * Fix output not JSON by @rvanderfeer in https://github.com/kiliczsh/mcp-mongo-server/pull/12
    * feat(call): add sort option to query operation by @s-xync in https://github.com/kiliczsh/mcp-mongo-server/pull/26
    
    ## New Contributors
    * @rvanderfeer made their first contribution in https://github.com/kiliczsh/mcp-mongo-server/pull/12
    * @s-xync made their first contribution in https://github.com/kiliczsh/mcp-mongo-server/pull/26
    
    **Full Changelog**: https://github.com/kiliczsh/mcp-mongo-server/compare/1.1.0...1.3.0
    View on GitHub ↗
  • 1.2.0 Apr 12, 2025
    ## What's Changed
    * feat: implement read-only mode for MongoDB connections by @kiliczsh in https://github.com/kiliczsh/mcp-mongo-server/pull/11
    * Fix output not JSON by @rvanderfeer in https://github.com/kiliczsh/mcp-mongo-server/pull/12
    
    ## New Contributors
    * @rvanderfeer made their first contribution in https://github.com/kiliczsh/mcp-mongo-server/pull/12
    
    ### Features
    - Added completion handler for MongoDB collections
    - Added automatic ObjectId conversion with configurable modes
      - Implemented intelligent conversion of string IDs to MongoDB ObjectId based on field names
      - Added new objectIdMode parameter supporting "auto", "none" or "force" conversion strategies
    - Added default value and schema improvements to tools endpoints
    - Added MongoDB environment variable support
      - MCP_MONGODB_URI
      - MCP_MONGODB_READONLY
    
    ### Bug Fixes
    - Fixed MCP ping tool error handling
    - Fixed commitQuorum type to string only in index creation schema
    
    ### Code Improvements
    - Refactored codebase into modular structure
    - Refactored MongoDB call handler for better code organization
    - Improved error handling
    
    ### Issues Resolved
    - #15: Automatic ObjectId conversion with configurable modes
    - #16: Default value and schema improvements to tools endpoints
    - #17 & #20: commitQuorum type in index creation schema
    
    **Full Changelog**: https://github.com/kiliczsh/mcp-mongo-server/compare/1.1.0...1.2.0
    View on GitHub ↗

Discussion (0)

Sign in to comment →

No comments yet. Sign in to start the discussion.

More Data servers