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
- 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
- query
- Execute MongoDB queries with filtering and projection
- Input parameters:
collection: Name of collection to queryfilter: 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: