What is Mongodb Mcp Bridge

mongodb-mcp-bridge is a powerful implementation of the Model Context Protocol (MCP) designed for seamless integration with MongoDB databases, allowing standardized interactions and operations.

Use cases

Use cases for mongodb-mcp-bridge include building RESTful APIs that interact with MongoDB, real-time data processing applications, and any application that requires robust database operations with error handling.

How to use

To use mongodb-mcp-bridge, you can run it directly using uvx or npx commands, set the required environment variables for MongoDB connection, and optionally use Docker for deployment.

Key features

Key features include full support for MongoDB CRUD operations, secure connection handling with MongoDB Atlas, async/await patterns for performance, comprehensive error handling, Docker support for easy deployment, and query execution with type hints.

Where to use

mongodb-mcp-bridge can be used in various fields that require database interactions, particularly in web applications, data analysis, and any system needing efficient MongoDB integration.

MongoDB MCP Server 🚀

A powerful Model Context Protocol (MCP) server implementation for MongoDB integration, providing seamless interaction with MongoDB databases through a standardized protocol.

🌟 Author

Syed Asad

📋 Overview

This MCP server implementation provides a robust interface for interacting with MongoDB databases through the Model Context Protocol. It supports operations on databases, collections, and documents with proper async/await patterns and error handling.

✨ Features

• 🔄 Full MongoDB CRUD operations support
• 🔐 Secure connection handling with MongoDB Atlas
• 🚦 Async/await patterns for optimal performance
• 🛡️ Comprehensive error handling
• 📦 Docker support for easy deployment
• 🔍 Query execution with proper type hints

🚀 Quick Start

Using uvx (Python)

# Run directly with uvx
uvx mongodb-mcp-bridge

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

Using npx (Node.js)

# Run directly with npx
npx mongodb-mcp-bridge

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

Environment Variables

Set these environment variables before running the server:

# Required
MONGODB_URI="your_mongodb_connection_string"

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

Using 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 Integration

VS Code Setup

Add this to your 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 Setup

For Cursor or Windsurf, configure the MCP server with:

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

📚 Available Tools

1. ping

   • Quick connection test to verify MongoDB connectivity

2. list_databases

   • List all available databases in the MongoDB instance

3. find_documents

   • Query documents in a collection with filtering options
   • Parameters:
     • database: Database name
     • collection: Collection name
     • query: MongoDB query object (optional)
     • limit: Maximum number of documents to return (default: 10)

🔍 Example Usage

Using the MCP Inspector (http://127.0.0.1:6274):

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol (MCP) team for the protocol specification
• MongoDB team for the excellent database and drivers
• All contributors and users of this project

Made with ❤️ by Syed Asad