MongoDB

Provides read-only access to MongoDB schemas and read-only queries via MCP for LLM integration.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-kiliczsh_mcp-mongo-server": {
      "command": "node",
      "args": [
        "~/mcp-mongo-server/build/index.js",
        "mongodb://muhammed:kilic@mongodb.localhost/namespace"
      ]
    }
  }
}

You can run the MCP MongoDB Server locally to explore MongoDB databases, inspect collection schemas, and run read-only queries. This server exposes collection schemas and provides tools to analyze data without altering it, making it ideal for integrating with MCP clients and LLM workflows.

How to use

You connect to the MCP MongoDB Server through a client that supports MCP stdio configuration. The server exposes read-only query and aggregation tools for any connected MongoDB database. Use the provided prompts to analyze collection structures, data types, and basic statistics, and run read-only queries or aggregates as needed.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

Install dependencies and build the server locally.

npm install

npm run build

For development with auto-rebuild use:

npm run watch

Additional setup and usage notes

Two MCP stdio configurations are provided to run the server directly from your environment. Each configuration starts the server in a distinct way and connects to a MongoDB URI.

Claude Desktop can load these MCP server configurations by placing them in the client’s MCP servers configuration. Use either the direct Node start with a built index or the npx launcher that runs the MCP package.

Configuration examples

{
  "mcpServers": {
    "mongodb_node": {
      "command": "node",
      "args": [
        "~/mcp-mongo-server/build/index.js",
        "mongodb://muhammed:kilic@mongodb.localhost/namespace"
      ]
    }
  }
}

Troubleshooting and tips

If you encounter debugging challenges since MCP servers communicate over stdio, use the MCP Inspector tool to access debugging tools in your browser. Run the inspector with the provided script to obtain the debugging URL.

Notes on installation with Claude Desktop

You can also configure Claude Desktop to run the MCP MongoDB Server via npx. This lets Claude start the server and connect to your MongoDB instance in a single step.

Available tools

query

Execute read-only MongoDB queries against the connected database. Input: query (object). Returns: text with results and insights.

aggregate

Execute read-only MongoDB aggregation operations against the connected database. Input: aggregate (object). Returns: text with results and insights.

collection_analysis

Prompts that analyze a collection's structure, data types, and basic statistics. Inputs: collection (string). Output: text with a summary.