mcp-mongo-server
Author: kiliczsh
Description: Model-Context-Protocol (MCP) server that lets LLMs inspect schemas and run queries/aggregations on MongoDB, with optional read-only mode and smart ObjectId conversion.
Stars: 249
Forks: 40
License: MIT License
Category: Open Source
Overview
Installation
1. Prerequisites
• Node.js ≥ 18 and npm/yarn/pnpm
• Running MongoDB (local Docker container or remote cluster).
Example local Docker:
docker run -d -p 27017:27017 --name mongo mongo:72. Install the server package
Global CLI (recommended for quick start):
npm install -g mcp-mongo-server
Project dependency:
npm install mcp-mongo-server --save3. Create a minimal configuration file (mcp.config.js / mcp.config.mjs)
module.exports = {
dbUri: process.env.MONGO_URI || "mongodb://localhost:27017/mcp", // Mongo connection string
port: process.env.MCP_PORT || 8080, // HTTP port
apiKey: process.env.MCP_API_KEY, // optional auth key
collections: ["documents"] // mongo collections to search
};4. Launch the server
• From CLI (global):
• With npx:
mcp-mongo-server --config ./mcp.config.js
npx mcp-mongo-server --config ./mcp.config.js5. Verify
-e MONGO_URI=mongodb://host.docker.internal:27017/mcp \
-e MCP_API_KEY=secret123 \
-p 8080:8080 kiliczsh/mcp-mongo-server
curl http://localhost:8080/health → 200 OK
Environment Variables quick-start
export MONGO_URI="mongodb://localhost:27017/mcp"
export MCP_PORT=8080
export MCP_API_KEY=secret123
mcp-mongo-server
Docker
docker run -d \
TypeScript projects can also import and embed the server:
import { createServer } from 'mcp-mongo-server';
createServer({ dbUri: 'mongodb://…' }).start();01
query
Execute MongoDB queries
02
aggregate
Run aggregation pipelines
03
count
Count matching documents
04
update
Modify documents
05
insert
Add new documents
06
createIndex
Create collection indexes
07
serverInfo
Get MongoDB server details
License: MIT License
Updated 7/15/2025