Mongodb

🚀 MCP MongoDB Server

MCP MongoDB Server is a tool that simplifies the operation and management of MongoDB. It offers a straightforward way to start, stop, and check the status of MongoDB, along with various configuration options and advanced features.

🚀 Quick Start

Start the MCP MongoDB Server

mcp-mongo-server --start

Stop the MCP MongoDB Server

mcp-mongo-server --stop

Check the Status of the MCP MongoDB Server

mcp-mongo-server --status

📦 Installation

Install via npm

npm install mcp-mongo-server

Global Installation

npm install -g mcp-mongo-server

Example Run

mcp-mongo-server --db=mongodb://localhost:27017/myDatabase

📚 Documentation

Configuration Options

Database Connection String

Specify the MongoDB connection string:

--db=mongodb://[username:password@]host1[:port1][,host2[:port2],...][/database]

Port Configuration

Set the MCP server port (default is 9005):

--port=9005

Advanced Features

Plugin Support

Load custom plugins through the plugins directory.

Extended Protocol

Follow the MCP protocol extension rules to add custom command handling.

💻 Usage Examples

Query Operations

Basic Query

{
  "collection": "users",
  "filter": { "age": { "$gt": 30 } },
  "projection": { "name": 1, "email": 1 }
}

Index Explanation

{
  "collection": "posts",
  "explain": true,
  "query": { "author": "user1" }
}

Aggregation Operations

{
  "collection": "orders",
  "$group": {
    "_id": "$customerId",
    "total": { "$sum": "$amount" }
  },
  "$sort": { "total": -1 }
}

Complete Code Examples

Simple Query Script

{
  "operation": "query",
  "collection": "users",
  "filter": { "age": { "$gt": 30 } },
  "projection": { "name": 1, "_id": 0 }
}

Plugin Development Example

// plugin.js
module.exports = {
  handleCommand: function(cmd) {
    // Handle custom commands
    return customResponse;
  }
};

🔧 Troubleshooting

Common Issues

• Unable to connect to MongoDB: Check if the connection string is correct and ensure that the MongoDB service is running.
• Port conflict: Try using a different port number.

Contact Support

Join the MCP user group or visit the GitHub repository to submit issues.

📄 License

The MCP MongoDB Server is licensed under the MIT License, which allows for free use, modification, and distribution. For more details, please refer to the LICENSE file in the project repository.