MongoDB MCP Server

Name: MongoDB MCP Server
Author: ryaker

@ryaker

代码仓库

关于 MongoDB MCP Server

A Model Context Protocol server for MongoDB integration with Claude

基本信息

分类

数据库

许可证

MIT

运行时

node

传输方式

stdio

发布者

ryaker

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mongo-custom-server": {
      "command": "node",
      "args": [
        "/Volumes/Dev/localDev/MCPServers/CustomMongo_clean/mongo-mcp-server.js"
      ],
      "env": {
        "MONGODB_URI": "",
        "DEFAULT_DATABASE": ""
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MongoDB MCP Server?

The MongoDB MCP Server is a Model Context Protocol implementation that bridges Claude with MongoDB databases. It enables Claude to perform a wide range of MongoDB operations—including querying, aggregation, data manipulation (CRUD), and database management—directly from a conversation. It is designed for users of Claude Desktop or Cursor who need to interact with MongoDB through AI.

How to use MongoDB MCP Server?

Install prerequisites (Node.js v14+, access to a MongoDB instance, and Claude Desktop or Cursor). Clone the repository, install dependencies with npm install, then configure the MCP client (Claude Desktop or Cursor) by adding an entry in its MCP settings with the absolute path to mongo-mcp-server.js and environment variables: MONGODB_URI (required) and optional DEFAULT_DATABASE. Restart the client to load the server.

Key features of MongoDB MCP Server

Comprehensive MongoDB operations: find, aggregate, count, distinct, sample.
CRUD support: insert, update, delete documents (single or bulk).
Database management: list databases, list collections, drop collections.
Query analysis via explain tool for aggregation pipelines.
Flexible database selection per operation (defaults to DEFAULT_DATABASE).
Secure connection using environment variables for credentials.

Use cases of MongoDB MCP Server

Query and analyze documents in a collection through natural language.
Insert, update, or delete documents without writing MongoDB queries manually.
Run aggregation pipelines and get execution plans for performance insights.
Manage collections and databases (list, drop) during conversations.
Count documents or get distinct values for a field across a database.

FAQ from MongoDB MCP Server

What runtime and dependencies are required?

Node.js v14 or newer, a MongoDB instance (local or Atlas), and the Claude Desktop or Cursor application. The server uses the MongoDB Node.js driver.

How is the connection string configured?

The MONGODB_URI environment variable must be set to a valid MongoDB connection string. The DEFAULT_DATABASE environment variable is optional and sets the default database if no database parameter is provided in a tool call.

Where does data live?

Data remains in the MongoDB instance specified by the connection string. The server does not store any data locally; it only acts as a bridge.

What are the known limits or constraints?

The sample tool has a default count of 5 and a maximum of 10. The find tool has a default limit of 10 and a maximum of 100. The dropCollection tool requires a confirm boolean parameter set to true to proceed.

What transport and authentication are used?

The server uses the MCP protocol over standard I/O (stdio) for communication with Claude. Authentication to MongoDB is handled via the connection string in the MONGODB_URI environment variable; no other authentication mechanism is provided.