Mongodb MCP 3e4f1d93

MCP数据服务

提供方 leorosignoli

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个生产就绪的MongoDB操作协议服务器,提供安全查询、性能监控和全面工具集。

一句话选型结论

按资料字段整理

Mongodb MCP 3e4f1d93 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

数据库工具TypeScript本地部署MongoDB协议查询安全性能监控生产就绪

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -e MONGODB_URI="mongodb://localhost:27017" mongodb-mcp-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mongodb MCP 3e4f1d93当前 7 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方leorosignoli上游标注的维护方 leorosignoli
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.4 KB
来自项目仓库与上游目录的原文,未做删改

MongoDB MCP Server

A production-ready Model Context Protocol (MCP) server for MongoDB operations with enhanced safety, performance monitoring, and comprehensive tooling.

Features

  • Read-Only Operations: Safe MongoDB queries with built-in restrictions
  • Comprehensive Toolset: 7 powerful tools for database exploration and analysis
  • Enhanced Safety: Query sanitization, rate limiting, and resource monitoring
  • Performance Monitoring: Built-in metrics, caching, and timeout management
  • Production Ready: Health checks, graceful shutdown, and comprehensive logging

Tools Available

1. query

Execute MongoDB find queries with safety restrictions.
- Parameters: database, collection, query, options
- Limits: Maximum 1000 documents per query
- Options: limit, skip, sort, projection

2. aggregate

Run aggregation pipelines (read-only operations only).
- Parameters: database, collection, pipeline, options
- Limits: Maximum 1000 batch size, 60 second timeout
- Safety: Blocks write operations in pipelines

3. listCollections

List all collections in a database.
- Parameters: database
- Returns: Collection names and metadata

4. listDatabases

List all accessible databases.
- Parameters: None
- Returns: Database names and sizes

5. getIndexes

View indexes for a collection.
- Parameters: database, collection
- Returns: Index definitions and statistics

6. explain

Analyze query performance and execution plans.
- Parameters: database, collection, query, options
- Verbosity: queryPlanner, executionStats, allPlansExecution
- Returns: Detailed execution analysis

7. stats

Get collection or database statistics.
- Parameters: database, collection (optional)
- Returns: Storage stats, document counts, index information

Installation

Prerequisites

  • Node.js >= 18.0.0
  • MongoDB connection (local or remote)

From NPM```bash

npm install -g mongodb-mcp-server


### From Source```bash
git clone https://github.com/your-repo/mongodb-mcp-server
cd mongodb-mcp-server
npm install
npm run build

Docker```bash

docker build -t mongodb-mcp-server .
docker run -e MONGODB_URI="mongodb://localhost:27017" mongodb-mcp-server


## Configuration

### Environment Variables

| Variable | Description | Default | Required |
|----------|-------------|---------|----------|
| `MONGODB_URI` | MongoDB connection string | `mongodb://localhost:27017` | Yes |
| `MONGODB_DATABASE` | Default database name | - | No |
| `MONGODB_TIMEOUT` | Connection timeout (ms) | `30000` | No |
| `MONGODB_MAX_POOL_SIZE` | Max connection pool size | `10` | No |
| `MONGODB_MIN_POOL_SIZE` | Min connection pool size | `2` | No |
| `LOG_LEVEL` | Logging level | `info` | No |
| `RATE_LIMIT_REQUESTS` | Max requests per minute | `100` | No |
| `CACHE_TTL` | Cache TTL in seconds | `300` | No |

### Connection String Examples```bash
# Local MongoDB
MONGODB_URI="mongodb://localhost:27017"

# MongoDB Atlas
MONGODB_URI="mongodb+srv://user:password@cluster.mongodb.net/database"

# Replica Set
MONGODB_URI="mongodb://user:password@host1:27017,host2:27017/database?replicaSet=myReplSet"

# With SSL
MONGODB_URI="mongodb://user:password@host:27017/database?ssl=true"

Usage

As MCP Server```bash

Start the server

mongodb-mcp-server

With custom configuration

MONGODB_URI="mongodb://localhost:27017/mydb" mongodb-mcp-server


### With Claude Desktop

Add to your `claude_desktop_config.json`:```json
{
  "mcpServers": {
    "mongodb": {
      "command": "mongodb-mcp-server",
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017"
      }
    }
  }
}

Example Queries```javascript

// Find documents
{
"database": "ecommerce",
"collection": "products",
"query": { "category": "electronics" },
"options": { "limit": 10, "sort": { "price": -1 } }
}

// Aggregation pipeline
{
"database": "ecommerce",
"collection": "orders",
"pipeline": [
{ "$match": { "status": "completed" } },
{ "$group": { "_id": "$customerId", "totalSpent": { "$sum": "$amount" } } },
{ "$sort": { "totalSpent": -1 } },
{ "$limit": 5 }
]
}

// Explain query performance
{
"database": "ecommerce",
"collection": "products",
"query": { "category": "electronics", "price": { "$lt": 500 } },
"options": { "verbosity": "executionStats" }
}


## Safety Features

### Query Restrictions
- **Read-Only**: All write operations are blocked
- **Result Limits**: Maximum 1000 documents per query
- **Timeout Protection**: Queries timeout after 60 seconds
- **Resource Monitoring**: Memory and CPU usage tracking

### Blocked Operations
- `drop`, `dropDatabase`
- `insert`, `insertOne`, `insertMany`
- `update`, `updateOne`, `updateMany`
- `delete`, `deleteOne`, `deleteMany`
- `remove`, `findAndModify`
- `createIndex`, `dropIndex`

### Rate Limiting
- Default: 100 requests per minute
- Configurable via `RATE_LIMIT_REQUESTS`
- Per-connection tracking

## Performance Features

### Caching
- Query result caching with 5-minute TTL
- Configurable cache size and expiration
- Automatic cache invalidation

### Connection Management
- Connection pooling with min/max sizes
- Automatic reconnection on failures
- Health check monitoring

### Monitoring
- Query execution metrics
- Connection pool statistics
- Error rate tracking
- Performance alerts

## Development

### Build```bash
npm run build

Development Mode```bash

npm run dev


### Testing```bash
npm test

Linting```bash

npm run lint
npm run lint:fix


### Type Checking```bash
npm run typecheck

Docker Usage

Build Image```bash

docker build -t mongodb-mcp-server .


### Run Container```bash
docker run -e MONGODB_URI="mongodb://host.docker.internal:27017" mongodb-mcp-server

Docker Compose```yaml

version: '3.8'
services:
mongodb-mcp:
build: .
environment:
- MONGODB_URI=mongodb://mongo:27017
- LOG_LEVEL=debug
depends_on:
- mongo

mongo:
image: mongo:7
ports:
- "27017:27017"


## Troubleshooting

### Common Issues

**Connection Refused**```bash
# Check MongoDB is running
mongosh --eval "db.runCommand('ping')"

# Test connection string
MONGODB_URI="your-connection-string" mongodb-mcp-server

Permission Denied```bash

Ensure user has read permissions

Add to MongoDB user roles: ["read", "readAnyDatabase"]


**High Memory Usage**```bash
# Reduce query limits
# Increase cache TTL
# Monitor query complexity

Debug Mode```bash

LOG_LEVEL=debug mongodb-mcp-server


### Health Check
The server provides a health check endpoint for monitoring:```bash
# Check server status
curl http://localhost:3000/health

Security Considerations

  • Network Security: Use SSL/TLS for production connections
  • Authentication: Always use authenticated MongoDB connections
  • Firewall: Restrict MongoDB access to authorized hosts only
  • Monitoring: Enable audit logging for security events
  • Updates: Keep dependencies updated for security patches

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Ensure all tests pass
  6. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

  • GitHub Issues: Report bugs and feature requests
  • Documentation: Check the docs/ directory for detailed guides
  • Examples: See examples/ directory for common use cases

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Mongodb MCP 3e4f1d93 怎么安装?

在客户端按下面的安装命令接入:docker run -e MONGODB_URI="mongodb://localhost:27017" mongodb-mcp-server。装完在客户端配置里引用同一个包或端点。

Mongodb MCP 3e4f1d93 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Mongodb MCP 3e4f1d93 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mongodb MCP 3e4f1d93 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Mongodb MCP 3e4f1d93 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 数据库工具、TypeScript、生产就绪、性能监控。具体工具清单以官方文档为准。

Mongodb MCP 3e4f1d93 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Mongodb MCP 3e4f1d93 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。