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://)
  • 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: