# 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`: