MCP Server for MongoDB in Golang

This project implements a MongoDB-compatible server in Golang, allowing clients to connect and interact with it as if it were a standard MongoDB server. The server supports basic CRUD operations, authentication, and other MongoDB features.

Features

The following mongodb features are supported:

• Aggregate
• CountDocuments
• DeleteMany
• DeleteOne
• FindOneAndDelete
• FindOneAndReplace
• FindOneAndUpdate
• FindOne
• Find
• InsertMany
• InsertOne
• UpdateMany
• UpdateOne
• ListCollections

Configurations

The server can be configured to run with the following environment variables:

DB_URL=
DB_NAME=
READ_ONLY=false
ALLOW_AGGREGATES=false

Variable	Description	Required	Default
DB_URL	The connection string for the MongoDB instance to connect to.	Yes	None
DB_NAME	The name of the MongoDB database to use. If not provided, the server will require the database name to be specified in each query.	No	None
READ_ONLY	If set to "true" or "1", the server will operate in read-only mode, disallowing any write operations.	No	false
ALLOW_AGGREGATES	If set to "true" or "1", the server will allow aggregate operations.	No	false

Usage

To run the server, use the following command:

go run main.go

Testing with MCP

Install the MCP Inspector using the following command:

npm install -g @modelcontextprotocol/inspector

Now, set your environment variables and run the server:

mcp-inspector go run .

Installing and running the project for production

Install the project with the following command:

go install github.com/CdTgr/mongodb_go_mcp/cmd/mongodb_go_mcp@latest

Now, you can freely connect your favourite MCP client to the server with the following execution command:

mongodb_go_mcp

Note: Make sure to set the required environment variables before running the server.