Skip to content

kiliczsh/mcp-mongo-server

MCP Data & Storage

A Model Context Protocol Server for MongoDB

TypeScript Latest 2.1.1 · 5d ago Security brief →

Features

  • Smart ObjectId handling with configurable conversion modes
  • Read‑only protection and secondary read preference
  • Automatic schema inference from document samples
  • Full MongoDB query and aggregation support (with explain plans)
  • Write operations (insert, update, index creation) when not in read‑only mode

Recent releases

View all 5 releases →
Upgrade now
2.1.1 Security relevant
Auth Breaking upgrade

Read‑only mode bypass fix

Config change
2.1.0 New feature
Auth

SEP-1303 execution errors

2.0.2 Breaking risk
Breaking changes
  • Dockerfile rewritten with multi-stage oven/bun + node:22-slim build
  • mcp-proxy dependency removed; HTTP transport now native
  • docker-compose.yml no longer uses tty/stdin_open
Notable features
  • Streamable HTTP transport with --transport http flag
  • Port configuration via --port and MCP_PORT env var
  • HTTP request logging with timestamp, client IP, method, status, duration
Full changelog

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

2.0.1 Breaking risk
Breaking changes
  • Dockerfile rewritten with multi-stage oven/bun + node:22-slim build
  • mcp-proxy dependency removed; HTTP transport now native
  • docker-compose.yml no longer uses tty/stdin_open
Notable features
  • Streamable HTTP transport with --transport http flag
  • Port configuration via --port and MCP_PORT env var
  • HTTP request logging with timestamp, client IP, method, status, duration
Full changelog

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

2.0.0 Breaking risk
Breaking changes
  • Dockerfile rewritten with multi-stage oven/bun + node:22-slim build
  • mcp-proxy dependency removed; HTTP transport now native
  • docker-compose.yml no longer uses tty/stdin_open
Notable features
  • Streamable HTTP transport with --transport http flag
  • Port configuration via --port and MCP_PORT env var
  • HTTP request logging with timestamp, client IP, method, status, duration
Full changelog

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

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
281
Forks
55
Languages
TypeScript Dockerfile
Downloads/week
187 ↑23%
NPM Maintainers
1
Contributors
8

Install & Platforms

Install via
npm

Beta — feedback welcome: [email protected]