MongoDB MCP Server 🚀

MongoDB MCP 服务 🚀

一个功能强大的 MongoDB 集成模型上下文协议（MCP）服务实现，可通过标准化协议与 MongoDB 数据库无缝交互。

🌟 作者

Syed Asad

📋 概述

此 MCP 服务实现通过模型上下文协议提供了一个可靠的接口，用于与 MongoDB 数据库交互。它支持对数据库、集合和文档执行操作，并采用适当的 async/await 模式和错误处理。

✨ 功能

• 🔄 全面支持 MongoDB CRUD 操作
• 🔐 使用 MongoDB Atlas 安全处理连接
• 🚦 采用 async/await 模式，实现最佳性能
• 🛡️ 全面的错误处理
• 📦 支持 Docker，便于部署
• 🔍 执行查询并提供适当的类型提示

🚀 快速开始

使用 uvx（Python）

# Run directly with uvx
uvx mongodb-mcp-bridge

# With SSE transport for remote connections
uvx mongodb-mcp-bridge --transport=sse

使用 npx（Node.js）

# Run directly with npx
npx mongodb-mcp-bridge

# With SSE transport for remote connections
npx mongodb-mcp-bridge --transport=sse

环境变量

运行服务前，请设置以下环境变量：

# Required
MONGODB_URI="your_mongodb_connection_string"

# Optional
MONGODB_DB="default_database_name"
MCP_PORT="6274"  # Default port for MCP Inspector

使用 Docker 🐳

# Build the Docker image
docker build -t mongodb-mcp-server .

# Run the container
docker run -e MONGODB_URI="your_mongodb_uri" -p 6274:6274 mongodb-mcp-server

🔗 IDE 集成

VS Code 设置

将以下内容添加到 VS Code 的 settings.json 中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "mongodbUri",
        "description": "MongoDB Connection URI"
      }
    ],
    "servers": {
      "mongodb": {
        "command": "uvx",
        "args": ["mongodb-mcp-bridge", "--transport=sse"],
        "env": {
          "MONGODB_URI": "$(mongodbUri)"
        }
      }
    }
  }
}

Cursor/Windsurf 设置

对于 Cursor 或 Windsurf，请按以下内容配置 MCP 服务：

{
  "mcp": {
    "servers": {
      "mongodb": {
        "url": "http://localhost:6274"
      }
    }
  }
}

📚 可用工具

1. ping

   • 快速连接测试，用于验证 MongoDB 连通性

2. list_databases

   • 列出 MongoDB 实例中所有可用的数据库

3. find_documents

   • 根据筛选选项查询集合中的文档
   • 参数：
     • database：数据库名称
     • collection：集合名称
     • query：MongoDB 查询对象（可选）
     • limit：要返回的文档数量上限（默认值：10）

🔍 使用示例

使用 MCP Inspector（http://127.0.0.1:6274）：

// List all databases
{
    "tool": "list_databases"
}

// Find documents in a collection
{
    "tool": "find_documents",
    "database": "your_database",
    "collection": "your_collection",
    "query": {"status": "active"},
    "limit": 5
}

🤝 参与贡献

欢迎贡献！请随时提交 Pull Request。

1. 复刻此仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到该分支（git push origin feature/AmazingFeature）
5. 发起 Pull Request

📄 许可证

此项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

🙏 致谢

• 感谢模型上下文协议（MCP）团队制定协议规范
• 感谢 MongoDB 团队提供出色的数据库和驱动程序
• 感谢所有为此项目贡献的人员和用户

---

由 Syed Asad 用 ❤️ 制作