First MCP

This project implements a MongoDB service interface based on the MCP protocol, providing standardized operations such as collection management and document query, supporting database functions like filtering and projection, and including secure connection and logging mechanisms.

Database Developer tools #MongoDB Interface #Document Query #MCP Protocol #Database Tool .TypeScript

rating : 2 points

downloads : 15

update time : 2025-04-28

What is the MCP MongoDB Server?

The MCP MongoDB Server is a tool based on the Model Context Protocol (MCP) that allows you to interact with a MongoDB database through a standard interface. You can easily manage collections, read documents, and perform advanced queries.

How to use the MCP MongoDB Server?

You can start using it in just a few steps: install the client, connect to a MongoDB instance, and query data with simple commands.

Applicable Scenarios

Suitable for enterprise-level applications, data analysis projects, and individual developers that need to efficiently access MongoDB data.

Main Features

Resource ManagementSupports listing all collections in MongoDB and displaying them as resources.

Document OperationsAllows reading and filtering documents in MongoDB, supports paginated display with a default limit of 100 records.

Query BuilderProvides a graphical interface or command-line tool to build complex MongoDB queries.

Advantages and Limitations

Advantages

The standardized interface simplifies the development process.

Built-in security mechanisms protect sensitive data.

A detailed logging system facilitates troubleshooting.

Limitations

May have limited performance for very large datasets.

Depends on the compatibility of the MongoDB driver version.

How to Use

Install the MCP Client

Download and install the official MCP SDK.

Configure the MongoDB Connection

Set the environment variable MONGODB_URI to point to your MongoDB instance.

Test the Connection

Run a test command to check if the connection to MongoDB is successful.

Usage Examples

List Collection DocumentsDemonstrate how to get all documents in a collection.

Advanced QueryShow how to use filters to get data that meets specific conditions.

Frequently Asked Questions

How to ensure data security?

What if the connection fails?

Related Resources

MCP Official Documentation

Understand the basics of the MCP protocol.

MongoDB Node.js Driver

Documentation for the official MongoDB Node.js driver.

GitHub Code Repository

View the source code and contribute code.

🚀 MCP MongoDB Server

This server implements the MongoDB version of the Model Context Protocol (MCP) interface, enabling interaction with MongoDB collections and documents through standard MCP requests.

🚀 Quick Start

This server allows users to interact with MongoDB collections and documents via standard MCP requests. It offers various functions such as resource management, document operations, query building, and ensures security and detailed logging.

✨ Features

Resource Management

List Collections: Enumerate all MongoDB collections as MCP resources.
- Each collection is represented in the mongodb:// URI format.
- Return MCP resource format including collection names and relevant metadata.

Document Operations

Read Documents: Retrieve documents from MongoDB collections.
- Use URIs in the format mongodb://collection-name to access collections.
- Support document filtering and projection.
- By default, return a maximum of 100 documents per request.

Tools

Query Builder: Structurally query MongoDB collections.
- Specify the name of the collection to be queried.
- Apply filtering conditions and projections.
- Configure result limits.

Security and Logging

Securely handle MongoDB connections.
Log detailed operation records to logs/server.log.
Handle and report connection errors.
Perform input validation on collection names and queries.

Configuration

Connect to MongoDB through environment variables (MONGODB_URI).
Configurable client options to optimize performance and security.
A timestamped logging system to record operations and errors.

🔧 Technical Details

Built with @modelcontextprotocol/sdk version 1.10.2.
Adopted MongoDB Node.js driver version 6.16.0.
Implemented MCP server functions, including resource and tool interfaces.

📚 Documentation

Components

Tools

query: Execute MongoDB queries with filtering, projection, and limits.
- Input parameters:
  - collection: Name of the collection to be queried.
  - filter: MongoDB query filter (optional).
  - projection: Fields to include or exclude (optional).
  - limit: Maximum number of documents to return, default is 100.

Resources

The server provides MongoDB collections as resources:

Collections (mongodb://<collection-name>)
- Each collection is exposed as a resource.
- Documents are returned in JSON format.
- Support filtering and projection through query tools.

Configuration

Usage on Claude Desktop

To use this server in Claude Desktop, add the following configuration to the claude_desktop_config.json file:

... (The configuration example in the original text is not fully displayed, but usually, you need to specify the server's address, port, and relevant parameters.)