MCP MongoDB 服务器

该服务器为 MongoDB 实现了模型上下文协议 (MCP) 接口，允许通过标准化的 MCP 请求与 MongoDB 集合和文档进行交互。

功能

资源管理

• 列出集合：将所有 MongoDB 集合作为 MCP 资源列出
  • 每个集合都使用 mongodb:// URI 方案表示
  • 以 MCP 资源格式返回集合名称和元数据

文档操作

• 读取文档：从 MongoDB 集合中检索文档
  • 使用 mongodb://collection-name URI 格式访问集合
  • 支持文档过滤和投影
  • 每次请求默认限制 100 条文档

工具

• 查询构建器：对 MongoDB 集合进行结构化查询
  • 指定集合名称
  • 应用过滤器和投影
  • 配置结果限制

安全性和日志记录

• 安全的 MongoDB 连接处理
• 详细的操作日志记录到 logs/server.log
• 连接错误处理和报告
• 对集合名称和查询的输入验证

配置

• 通过环境变量 (MONGODB_URI) 进行 MongoDB 连接
• 可配置的客户端选项以提高性能和安全性
• 带有时间戳和错误跟踪的日志系统

技术细节

• 使用 @modelcontextprotocol/sdk 版本 1.10.2 构建
• 使用 MongoDB Node.js 驱动程序版本 6.16.0
• 实现了资源和工具的 MCP 服务器功能

组件

工具

• query
  • 执行带有过滤和投影的 MongoDB 查询
  • 输入参数：
    • collection: 要查询的集合名称
    • filter: MongoDB 查询过滤器（可选）
    • projection: 要包含/排除的字段（可选）
    • limit: 返回的最大文档数量（默认 100）

资源

服务器将 MongoDB 集合作为资源提供：

• 集合 (mongodb://<collection-name>)
  • 每个集合都作为资源暴露
  • 文档以 JSON 格式返回
  • 通过查询工具支持过滤和投影

配置

与 Claude Desktop 一起使用

要与此服务器配合使用 Claude Desktop，请在您的 claude_desktop_config.json 中添加以下内容：