MCP MongoDB Server

This server implements a Model Context Protocol (MCP) interface for MongoDB, allowing interaction with MongoDB collections and documents through standardized MCP requests.

Features

Resource Management

• List Collections: Lists all MongoDB collections as MCP resources

  • Each collection is represented with a mongodb:// URI scheme

  • Returns collection names and metadata in MCP resource format

Document Operations

• Read Documents: Retrieve documents from MongoDB collections

  • Access collections using mongodb://collection-name URI format

  • Supports filtering and projection of documents

  • Default limit of 100 documents per request

Tools

• Query Builder: Structured querying of MongoDB collections

  • Specify collection name

  • Apply filters and projections

  • Configure result limits

Security & Logging

• Secure MongoDB connection handling

• Detailed operation logging to logs/server.log

• Connection error handling and reporting

• Input validation for collection names and queries

Configuration

• MongoDB connection via environment variables (MONGODB_URI)

• Configurable client options for performance and security

• Logging system with timestamp and error tracking

Technical Details

• Built with @modelcontextprotocol/sdk version 1.10.2

• Uses MongoDB Node.js driver version 6.16.0

• Implements MCP server capabilities for resources and tools

Components

Tools

• query

  • Execute MongoDB queries with filtering and projection

  • Input parameters:

    • collection: Name of collection to query

    • filter: MongoDB query filter (optional)

    • projection: Fields to include/exclude (optional)

    • limit: Maximum number of documents to return (default 100)

Resources

The server provides access to MongoDB collections as resources:

• Collections (mongodb://<collection-name>)

  • Each collection is exposed as a resource

  • Documents are returned in JSON format

  • Supports filtering and projection via query tool

Configuration

Usage with Claude Desktop

To use this server with Claude Desktop, add the following to your claude_desktop_config.json: