A read-only MongoDB MCP (Model Context Protocol) server designed for serverless deployment on Vercel. Provides secure, limited access to MongoDB databases for AI assistants and MCP-compatible clients.
- 🔒 Secure by default - API key authentication, read-only operations, query limits
- ⚡ Serverless optimized - Designed for Vercel's edge/serverless environment
- 🛡️ Safety guardrails - Dangerous operators blocked, query timeouts, result limits
- 📊 6 MongoDB tools - find, aggregate, count, list-collections, explain, collection-schema
npm installCreate a .env.local file:
# MongoDB Connection (use a read-only user!)
MONGODB_URI=mongodb+srv://readonly_user:[email protected]
MONGODB_DB=your_database_name
# API Key for authentication (generate with: openssl rand -base64 32)
API_KEY=your_generated_api_keynpm run devThe MCP server will be available at http://localhost:3000/mcp
| Tool | Description |
|---|---|
find |
Query documents with filtering, projection, sorting, and limiting |
aggregate |
Run aggregation pipelines for data transformation and analysis |
count |
Count documents matching a filter |
list-collections |
List all user collections in the database |
explain |
Get query execution plans for performance analysis |
collection-schema |
Infer schema by sampling documents |
- Fixed database - Only the database specified in
MONGODB_DBis accessible - API key required - All requests must include
X-API-Keyheader - Query limits - Max 100 documents per query, 30s timeout
- Blocked operators -
$where,$function,$accumulatorare rejected - Blocked stages -
$out,$merge,$lookupare rejected in aggregations - EJSON serialization - Proper handling of BSON types (ObjectId, Date, etc.)
- Use a read-only MongoDB user - Create a user with only
readrole - Rotate API keys - Generate new keys periodically
- Monitor usage - Enable Vercel Analytics to track requests
# Initialize connection
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'
# List available tools
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'
# Call a tool (list collections)
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list-collections","arguments":{}},"id":3}'
# Find documents
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"find","arguments":{"collection":"users","filter":{"status":"active"},"limit":10}},"id":4}'- Open MCP Inspector
- Set Transport Type:
Streamable HTTP - Set URL:
http://localhost:3000/mcp - In Authentication > Custom Headers, add:
X-API-Key: your API keyAccept:application/json, text/event-stream
- Enable both header toggles and click Connect
Add to your .cursor/mcp.json:
{
"mcpServers": {
"mongodb": {
"url": "http://localhost:3000/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}For production deployment:
{
"mcpServers": {
"mongodb": {
"url": "https://your-app.vercel.app/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/your-username/your-repo.git
git push -u origin main- Go to vercel.com/new
- Import your GitHub repository
- Add environment variables:
MONGODB_URIMONGODB_DBAPI_KEY
- Deploy
Make sure your MongoDB Atlas cluster allows connections from Vercel:
- Add
0.0.0.0/0to IP Access List (for serverless), or - Use Vercel's static IP addresses
Query documents from a collection.
{
"collection": "users",
"filter": { "status": "active" },
"projection": { "name": 1, "email": 1, "_id": 0 },
"sort": { "createdAt": -1 },
"limit": 10
}Run an aggregation pipeline.
{
"collection": "orders",
"pipeline": [
{ "$match": { "status": "completed" } },
{ "$group": { "_id": "$customerId", "total": { "$sum": "$amount" } } },
{ "$sort": { "total": -1 } }
]
}Count documents matching a filter.
{
"collection": "products",
"filter": { "inStock": true }
}List all collections in the database. No arguments required.
{}Get the execution plan for a query.
{
"collection": "users",
"operation": "find",
"operationArgs": {
"filter": { "email": "[email protected]" }
}
}Infer schema by sampling documents.
{
"collection": "users",
"sampleSize": 100
}| Variable | Required | Description |
|---|---|---|
MONGODB_URI |
Yes | MongoDB connection string |
MONGODB_DB |
Yes | Database name to use |
API_KEY |
Yes | API key for authentication |
This project combines ideas and code from:
-
vercel-labs/mcp-for-next.js - Vercel's official template for deploying MCP servers on Next.js. Provides the serverless-compatible architecture and
mcp-handlerintegration. -
mongodb-js/mongodb-mcp-server - MongoDB's official MCP server. The tool implementations (find, aggregate, count, explain, collection-schema) are adapted from this project with security hardening for public deployment.