MCP MongoDB Server

MCP MongoDB Server

site icon
2025.04.17 148
TypeScript数据库中间件MongoDB 访问数据库
MCP MongoDB Server 是一个基于 Model Context Protocol 的服务,提供对 MongoDB 数据库的访问能力。该服务使 LLMs(大型语言模型)能够检查集合模式并执行 MongoDB 操作。
View on GitHub

Overview

基本能力

产品定位

MCP MongoDB Server 是一个数据库中间件服务,专门为 LLMs 提供 MongoDB 数据库的访问和操作能力。

核心功能

  1. 只读模式
  2. 通过 --read-only-r 标志连接 MongoDB
  3. 阻止写操作(更新、插入、创建索引)
  4. 使用 MongoDB 的次要读取偏好以获得最佳读取性能
  5. 为生产数据库连接提供额外的安全性

  6. 资源访问

  7. 通过 mongodb:// URI 列出和访问集合
  8. 每个集合都有名称、描述和模式
  9. 提供 JSON 类型的模式访问

  10. 工具集

  11. query:执行 MongoDB 查询,可选执行计划分析
  12. aggregate:执行 MongoDB 聚合管道,可选执行计划分析
  13. update:更新集合中的文档
  14. serverInfo:获取 MongoDB 服务器信息和状态
  15. insert:将文档插入集合
  16. createIndex:在集合上创建索引
  17. count:计算匹配查询的文档数量

  18. 提示功能

  19. analyze_collection:分析集合结构和内容

适用场景

  1. 为 LLMs 提供 MongoDB 数据库访问能力
  2. 数据库模式分析和文档查询
  3. 数据库聚合操作和分析
  4. 数据库维护和监控

使用教程

使用依赖

npm install

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发模式(自动重建):
npm run watch

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

工具列表

  1. query:执行 MongoDB 查询
  2. aggregate:执行 MongoDB 聚合管道
  3. update:更新文档
  4. serverInfo:获取服务器信息
  5. insert:插入文档
  6. createIndex:创建索引
  7. count:计算文档数量

常见问题解答

  1. 如何启用只读模式? 使用 --read-only-r 标志启动服务器

  2. 如何调试服务? 使用 npm run inspector 启动调试工具

  3. 如何安装到 Claude Desktop? 修改 claude_desktop_config.json 配置文件

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。