Mongodb MCP Bridge

MongoDB MCP服务器🚀

用于MongoDB集成的强大模型上下文协议（MCP）服务器实现，通过标准化协议提供与MongoDB数据库的无缝交互。

🌟 作者

赛义德·阿萨德

📋 概述

此MCP服务器实现提供了一个健壮的接口，用于通过模型上下文协议与MongoDB数据库进行交互。它支持使用适当的异步/等待模式和错误处理对数据库、集合和文档进行操作。

✨ 特性

• 🔄 完全支持MongoDB CRUD操作
• 🔐 使用MongoDB Atlas进行安全连接处理
• 🚦 异步/等待模式可实现最佳性能
• 🛡️ 全面的错误处理
• 📦 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代码设置

将此添加到您的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，配置MCP服务器：

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

📚 可用工具

1. 拼

- 快速连接测试，验证MongoDB连接

1. 列表_数据库

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

1. find_文档

- 使用筛选选项查询集合中的文档 - 参数： - database：数据库名称 - collection：集合名称 - query：MongoDB查询对象（可选） - limit：要返回的最大文档数（默认值：10）

🔍 示例用法

使用MCP检查器(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
}

🤝 贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支(git push origin feature/AmazingFeature)
5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 协议规范的模型上下文协议（MCP）团队
• MongoDB团队提供卓越的数据库和驱动程序
• 本项目的所有贡献者和用户

______________________________________________________________________

由以下材料制成❤️ 通过Syed Asad