Mongodb MCP Server 3o3

🚀 MongoDB Model Context Protocol (MCP) Server

The MongoDB Model Context Protocol (MCP) Server is a powerful tool that enables seamless interaction with MongoDB databases. It translates MongoDB operations into MCP-compliant tools, validates inputs for security, and returns query results to LLM clients in a structured format.

🚀 Quick Start

1. Install Dependencies

npm install

2. Build the Project

npm run build

3. Start in Development Mode

npm run dev

4. Run Tests

npm test

✨ Features

• Database Connection: Establish a connection using the provided MongoDB connection string.
• Operation Tools: Convert MongoDB operations into tools that adhere to the MCP specification.
• Input Validation: Use Zod for type-safe and secure input validation.
• Query Execution: Execute queries and return structured data to LLM clients.
• Connection Pool Management: Handle connection pools and errors to ensure stable operation.

📦 Installation

Local Run

Use the npx method as shown in the Quick Start section.

Global Installation

Install the global package using npm:

npm install -g @coderay/mongo-mcp-server

Docker Container

Refer to the Dockerfile in the repository for deployment.

Platform Services

Deploy as a service on platforms such as Heroku, Vercel, or AWS.

🔧 Technical Details

• TypeScript: Used for type-safe development.
• MongoDB Node.js Driver: Employed for database operations.
• Zod: Utilized for schema validation.
• Model Context Protocol SDK: Implemented for the server.

⚠️ Important Note

⚠️ Important Note

Always follow the principle of least privilege when configuring database access.

💡 Usage Tip

💡 Usage Tip

Consider the following security measures:

1. Create a dedicated MongoDB user.
2. Avoid using administrative credentials.
3. Enable access logging.
4. Set appropriate read and write permissions.
5. Use connection string parameters.
6. Consider an IP whitelist.

🌐 How It Works

1. Establish a connection using the provided MongoDB connection string.
2. Expose MongoDB operations as MCP-compliant tools.
3. Validate inputs using Zod to ensure type safety and security.
4. Execute queries and return structured data to LLM clients.
5. Manage connection pools and handle errors.

💻 Usage Examples

Available Tools

Query Tools

• listCollections: List available collections in the database.
• find: Query documents based on filters and projections.
• insertOne: Insert a single document into a collection.
• updateOne: Update a single document in a collection.
• deleteOne: Delete a single document from a collection.

Index Tools

• createIndex: Create a new index on a collection.
• dropIndex: Remove an index from a collection.
• indexes: List the indexes of a collection.

🤝 Contribution Guidelines

Contributions are welcome! Please follow these steps to submit a pull request:

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Open a pull request.

📄 License

This project is released under the MIT License. See the LICENSE file for details.