AI导哈

MongoDB MCP 服务器

一个基于Embabel框架和Spring Boot的MongoDB MCP服务器，充当AI代理与MongoDB数据库之间的桥梁，支持通过自然语言进行数据库操作。

  • by BootcampToProd
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 BootcampToProd/embabel-mongo-mcp-server

使用说明

🍃 Embabel框架：MongoDB MCP服务器

此存储库演示了如何构建 MongoDB MCP服务器 使用 Embabel框架 以及Spring Boot。该应用程序充当AI代理（如Claude Desktop）和您的 MongoDB数据库，允许人工智能列出数据库，运行复杂的查询，并通过自然语言插入文档。

⚠️ 注： 这是 不 官方MongoDB MCP服务器。它是一个 演示 MCP服务器是专门为演示开发人员如何使用Embabel Framework构建与数据库交互的MCP服务器而创建的。

📖 完整指南：有关详细解释和完整代码演练，请阅读我们的综合教程。
👉 使用Embabel框架构建MongoDB MCP服务器

🎥 视频教程：更喜欢动手学习？观看我们的分步实施指南。
👉 YouTube教程-即将推出！！

✨ 这个项目展示了什么

此应用程序展示了如何 将AI代理连接到数据库 使用MCP服务器：

  • 模型上下文协议（MCP） 使用Embabel框架实现。
  • 数据库集成 将AI代理连接到MongoDB。
  • 工具曝光 使用Embabel的 @Export 注释，将Java服务方法转化为AI工具。
  • 数据操作 包括列出数据库/集合、执行简单和复杂的JSON查询、管理索引和插入文档。

📋 先决条件

在运行此应用程序之前，请确保您已经：

  • Java 21 或更高
  • OpenRouter API密钥 （免费套餐可在 OpenRouter.ai)
  • MongoDB实例 （在端口27017上本地运行或通过MongoDB Atlas运行）
  • Node.js （可选，如果使用MCP检验员进行测试，则为必填项）
  • Claude桌面应用程序 （可选，用于真实世界的代理测试）

🚀 快速开始

1.️⃣ 克隆存储库

git clone https://github.com/BootcampToProd/embabel-mongo-mcp-server.git
cd embabel-mongo-mcp-server

2.️⃣ 配置环境变量

提供您的OpenRouter API密钥和MongoDB连接详细信息。

OPENAI_API_KEY={YOUR_OPENROUTER_API_KEY}
MONGO_HOST=localhost
MONGO_PORT=27017

3.️⃣ 构建项目

mvn clean install

4.️⃣ 运行应用程序

mvn spring-boot:run

服务器将于启动 http://localhost:8080MCP端点暴露于 /sse.

💡 如何测试

您可以使用以下命令测试服务器 克劳德桌面版 或 MCP检查员.

🤖 选项1:克劳德桌面（推荐）

  1. 打开您的Claude Desktop配置文件：

    • 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json

  2. 添加以下配置：

{
  "mcpServers": {
    "embabel-mongo-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8080/sse"
      ]
    }
  }
}

  1. 重新启动克劳德桌面。您应该看到您的mcp服务器和可用工具。

  2. 问克劳德：

    • “列出所有数据库。”
    • “在'test_db'中创建一个名为'users'的集合。”
    • “将一个名为Alice的28岁用户插入到'test_db.users'中。”
    • “在'test_db.users'中查找年龄大于25岁的所有用户。”

🔍 选项2:MCP检查员

如果要手动调试工具：

  1. 确保Spring Boot应用程序正在运行。
  2. 在终端中运行检查器：
    npx @modelcontextprotocol/inspector
  3. 在打开的浏览器窗口中：
    • 选择 上海证券交易所.
    • 输入URL: http://localhost:8080/sse.
    • 点击 连接 并通过UI测试工具。

相关 MCP