MCP Database Server

What is MCP Database Server?

MCP Database Server is a Model Context Protocol (MCP) server that enables Large Language Models (LLMs) to interact with databases using natural language. Currently it supports MongoDB, with planned support for PostgreSQL, CockroachDB, Redis, and more. It is designed for developers building LLM-powered applications, such as those running on Claude Desktop.

How to use MCP Database Server?

Install Node.js v20.12.2 or higher, clone the repository, run npm install and npm run build. Then configure your MongoDB connection string as the MONGODB_URI environment variable in your Claude Desktop configuration file (claude_desktop_config.json). Once set up, you can ask Claude to list collections, query, insert, delete, or aggregate data in plain English.

Key features of MCP Database Server

• Natural language database queries and operations
• Full MongoDB CRUD support (list, query, insert, delete, aggregate)
• Future support for PostgreSQL, CockroachDB, and Redis
• Easy integration with Claude Desktop via MCP protocol
• Configurable document limit (default 10, max 1000)
• Aggregation pipeline execution

Use cases of MCP Database Server

• Explore database structure by asking “list all collections”
• Retrieve records with filters like “show all active users”
• Insert new documents via natural language commands
• Delete specific records based on conditions
• Run aggregation pipelines to summarize data (e.g., count by status)

FAQ from MCP Database Server

Which databases are currently supported?

Currently only MongoDB is fully supported. PostgreSQL, CockroachDB, and Redis are planned for future releases.

What are the prerequisites to use this server?

You need Node.js v20.12.2+, a running MongoDB instance, and the Claude Desktop application.

How do I configure my database connection?

Set the MONGODB_URI environment variable in your Claude Desktop config file (e.g., claude_desktop_config.json) with your MongoDB connection string.

Is it safe to commit my database connection string to version control?

No. The README explicitly warns not to commit connection strings; use environment variables and follow database-specific security best practices.

What is the maximum number of documents I can retrieve in one query?

The getCollection tool returns up to 1000 documents by default, with a configurable limit (minimum 1, default 10).