First MCP

该项目实现了一个基于MCP协议的MongoDB服务接口，提供集合管理、文档查询等标准化操作，支持过滤、投影等数据库功能，并包含安全连接和日志记录机制。

数据库开发者工具 #MongoDB接口 #文档查询 #MCP协议 #数据库工具 .TypeScript

评分 : 2分

下载量 : 8.1K

更新时间 : 2025-04-28

打开站点

什么是MCP MongoDB服务器？

MCP MongoDB服务器是一个基于Model Context Protocol（MCP）的工具，它允许您通过标准接口与MongoDB数据库进行交互。您可以轻松地管理集合、读取文档以及执行高级查询。

如何使用MCP MongoDB服务器？

只需几步即可开始使用：安装客户端、连接到MongoDB实例、并通过简单的命令查询数据。

适用场景

适用于需要高效访问MongoDB数据的企业级应用、数据分析项目和个人开发者。

主要功能

资源管理

支持列出MongoDB中的所有集合，并将其作为资源展示。

文档操作

允许读取和过滤MongoDB中的文档，支持分页显示，默认限制为100条记录。

查询构建器

提供图形化界面或命令行工具来构建复杂的MongoDB查询。

优势

标准化接口简化开发流程。

内置安全机制保护敏感数据。

详细的日志系统便于故障排查。

局限性

对非常大的数据集可能性能有限。

依赖于MongoDB驱动程序版本兼容性。

如何使用

安装MCP客户端

下载并安装官方提供的MCP SDK。

配置MongoDB连接

设置环境变量MONGODB_URI指向您的MongoDB实例。

测试连接

运行测试命令检查是否成功连接到MongoDB。

使用案例

列出集合文档

演示如何获取某个集合内的所有文档。

高级查询

展示如何利用过滤器获取特定条件的数据。

常见问题

如何确保数据的安全性？

如果遇到连接失败怎么办？

🚀 MCP MongoDB 服务器

本服务器实现了 Model Context Protocol (MCP) 接口的 MongoDB 版本，借助标准 MCP 请求，可与 MongoDB 集合和文档进行交互，为数据操作提供便利。

🚀 快速开始

本服务器实现了 MCP 接口的 MongoDB 版本，允许通过标准 MCP 请求与 MongoDB 集合和文档进行交互。若要在 Claude Desktop 中使用此服务器，需在 claude_desktop_config.json 文件中添加相应配置（原文配置示例未完整显示，通常需指定服务器的地址、端口及相关参数）。

✨ 主要特性

资源管理

列出集合：可列举所有 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。