mcp-mongo-server | 通往MCP之路

MCP MongoDB Server

https://img.shields.io/npm/v/mcp-mongo-server

https://img.shields.io/npm/dm/mcp-mongo-server

https://img.shields.io/npm/l/mcp-mongo-server

MCP MongoDB Server 是一个 Model Context Protocol 服务器，使 LLMs（大型语言模型）能够与 MongoDB 数据库进行交互。该服务器通过标准化接口提供了检查集合模式和执行 MongoDB 操作的能力。

演示

View on Smithery

主要特性

智能 ObjectId 处理

在字符串 ID 和 MongoDB ObjectId 之间进行智能转换

可通过 objectIdMode 参数配置：

"auto": 根据字段名自动转换（默认）
"none": 不进行转换
"force": 强制将所有字符串 ID 字段转换为 ObjectId

灵活的配置

环境变量：

MCP_MONGODB_URI: MongoDB 连接 URI
MCP_MONGODB_READONLY: 设置为 "true" 时启用只读模式

命令行选项：

--read-only 或 -r: 以只读模式连接

只读模式

防止执行写操作（更新、插入、创建索引）

使用 MongoDB 的次要读取偏好以获得最佳性能

适用于安全地连接到生产数据库

MongoDB 操作

读取操作：

查询文档，可选择执行计划分析
执行聚合管道
统计符合条件的文档数量
获取集合模式信息

写入操作（不在只读模式时）：

更新文档
插入新文档
创建索引

LLM 集成

集合补全功能，增强 LLM 交互

模式推断，提升上下文理解

集合分析，获取数据洞察

安装

全局安装

开发环境安装

使用

基本用法

环境变量

您可以使用环境变量配置服务器，这在 CI/CD 管道、Docker 容器或不想在命令行参数中暴露连接详细信息时特别有用：

在 Claude Desktop 配置中使用环境变量：

在 Docker 中使用环境变量：

与 Claude Desktop 集成

手动配置

将服务器配置添加到 Claude Desktop 的配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

命令行参数方式：

环境变量方式：

GitHub 包使用：

与 Windsurf 和 Cursor 集成

MCP MongoDB Server 可以以与 Claude Desktop 类似的方式与 Windsurf 和 Cursor 一起使用。

Windsurf 配置

将服务器添加到 Windsurf 配置中：

Cursor 配置

对于 Cursor，将服务器配置添加到您的设置中：

您也可以使用环境变量方式与 Windsurf 和 Cursor 集成，遵循与 Claude Desktop 配置相同的模式。

自动安装

使用 Smithery：

使用 mcp-get：

可用工具

查询操作

query: 执行 MongoDB 查询

aggregate: 运行聚合管道

count: 统计匹配的文档数量

写入操作

update: 修改文档

insert: 添加新文档

createIndex: 创建集合索引

系统操作

serverInfo: 获取 MongoDB 服务器详细信息

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会比较困难。使用 MCP Inspector 以获得更好的可见性：

这将提供一个 URL，您可以在浏览器中访问调试工具。

许可证

此 MCP 服务器根据 MIT 许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目仓库中的 LICENSE 文件。