Skip to content

kiliczsh/mcp-mongo-server

MCP Data & Storage

A Model Context Protocol server that lets LLMs query and manipulate MongoDB databases via a standardized interface

TypeScript Latest 2.0.2 · 3mo ago Security brief →

Features

  • Smart ObjectId handling with configurable conversion modes
  • Read‑only protection using secondary read preference
  • Automatic schema inference from document samples
  • Full support for MongoDB queries, aggregations and explain plans
  • Write operations (insert, update, index creation) when not in read‑only mode
  • Collection name autocompletion for LLM integration

Recent releases

View all 3 releases →
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
279
Forks
54
Languages
TypeScript Dockerfile
Downloads/week
260 ↑10%
NPM Maintainers
1
Contributors
7

Install & Platforms

Install via
npm

Beta — feedback welcome: [email protected]