[{"_1":2,"_282":-5,"_283":-5},"loaderData",{"_3":4,"_53":54,"_55":56,"_57":58,"_230":231},"root",{"_5":6,"_49":50,"_51":52},"appGlobal",{"_7":8,"_38":39,"_40":41},"config",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":-5,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":31,"_35":31,"_36":37},"APP_URL","https://glama.ai","CLIENT_ASSETS_URL","https://static.glama.ai/client/","ENVIRONMENT","LIVE","FACEBOOK_PIXEL_ID","1988603181578092","GOOGLE_ANALYTICS_MEASUREMENT_ID","G-GDQ5NW5CB5","GOOGLE_OAUTH2_CLIENT_ID","48173796263-7ohlqirg28gh2a7nel61coff3m1ogjtc.apps.googleusercontent.com","INTERCOM_APP_ID","wgcqevfz","INTERCOM_USER_HASH","POSTHOG_API_KEY","phc_aK0RnJxBEBRE0h0LIz21yyc9w6ylBxwUHMPB4712Bjc","REDDIT_PIXEL_ID","a2_fcqsoymvje51","RELEASE_VERSION","glama@fe0ec19","SENTRY_DRY_RUN",false,"SENTRY_DSN","https://fc82aa9f808b13927ff29c56bda4d486@o4507975513735168.ingest.us.sentry.io/4507975514849280","SENTRY_SPOTLIGHT","SENTRY_TRACE","STRIPE_PUBLIC_KEY","pk_live_51QpZQ32LV3sZcHqzHlFuNhgSfggSNaQqCzZw9EMJ8tbhpQyZgcwQj1vz168FxQ35EGRcztKu2MankxiSs7zLCF4g00blUverGs","viewportWidth",1280,"visitorSession",{"_42":43,"_45":-5,"_46":47,"_48":-5},"attributes",[44],"BOT","membership","uid","F6zDkfYZIv","userAccount","nonce","7be6127419b3c9f7279a84511e9c2221","toasts",[],"routes/_public/_layout",{},"routes/_public/mcp/servers/~uid/_layout",{},"routes/_public/mcp/servers/~uid/_pages/_layout",{"_59":-5,"_60":61,"_149":150},"githubUser","mcpServer",{"_62":63,"_64":65,"_42":77,"_83":84,"_85":84,"_86":87,"_92":93,"_111":112,"_113":31,"_114":115,"_116":117,"_121":-5,"_122":123,"_124":125,"_132":-5,"_133":134,"_139":-5,"_140":141,"_145":-5,"_46":146,"_147":148},"addedAt",["D",1741480365238],"argumentsJsonSchema",{"_66":67,"_68":69,"_71":72},"type","object","required",[70],"MONGO_URI","properties",{"_70":73},{"_66":74,"_75":76},"string","description","MongoDB connection string in the format mongodb+srv://username:password@hostname/?options",[78,79,80,81,82],"category:databases","category:search","category:developer-tools","hosting:hybrid","language:typescript","descriptionMarkdown","A protocol server that enables LLMs like Claude to interact with MongoDB databases, providing tools for schema exploration, aggregation queries, and data analysis through natural language in Cursor.","descriptionPlainText","githubProject",{"_88":89,"_90":91},"readme","# 🗄️ MongoDB MCP Server for LLMS\n\n[![Node.js 18+](https://img.shields.io/badge/node-18%2B-blue.svg)](https://nodejs.org/en/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![npm version](https://badge.fury.io/js/%40coderay%2Fmongo-mcp-server.svg)](https://www.npmjs.com/package/@coderay/mongo-mcp-server)\n[![smithery badge](https://smithery.ai/badge/mongo-mcp)](https://smithery.ai/server/mongo-mcp)\n\nA Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.\n\n## 📚 What is Model Context Protocol (MCP)?\n\nThe Model Context Protocol (MCP) is an open standard developed by Anthropic that creates a universal way for AI systems to connect with external data sources and tools. MCP establishes a standardized communication channel between:\n\n- **MCP Clients**: AI assistants like Claude that consume data (e.g., Claude Desktop, Cursor.ai)\n- **MCP Servers**: Services that expose data and functionality (like this MongoDB server)\n\nKey benefits of MCP:\n- **Universal Access**: Provides a single protocol for AI assistants to query data from various sources\n- **Standardized Connections**: Handles authentication, usage policies, and data formats consistently\n- **Sustainable Ecosystem**: Promotes reusable connectors that work across multiple LLM clients\n\n## ✨ Features\n\n- 🔍 Collection schema inspection\n- 📊 Document querying and filtering\n- 📈 Index management\n- 📝 Document operations (insert, update, delete)\n- 🔒 Secure database access through connection strings\n- 📋 Comprehensive error handling and validation\n\n## 📋 Prerequisites\n\nBefore you begin, ensure you have:\n\n- [Node.js](https://nodejs.org/) (v18 or higher)\n- [MongoDB](https://www.mongodb.com/) instance (local or remote)\n- An MCP client like [Claude Desktop](https://claude.ai/download) or [Cursor.ai](https://cursor.sh/)\n\nYou can verify your Node.js installation by running:\n```bash\nnode --version # Should show v18.0.0 or higher\n```\n\n## 🚀 Quick Start\n\nTo get started, find your MongoDB connection URL and add this configuration to your Claude Desktop config file:\n\n**MacOS**: `~/Library/Application\\ Support/Claude/claude_desktop_config.json` \n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"mongodb\": {\n \"command\": \"npx\",\n \"args\": [\n \"mongo-mcp\",\n \"mongodb://:@:/?authSource=admin\"\n ]\n }\n }\n}\n```\n\n### Installing via Smithery\n\n[Smithery.ai](https://smithery.ai) is a registry platform for MCP servers that simplifies discovery and installation. To install MongoDB MCP Server for Claude Desktop automatically via Smithery:\n\n```bash\nnpx -y @smithery/cli install mongo-mcp --client claude\n```\n\n### Cursor.ai Integration\n\nTo use MongoDB MCP with Cursor.ai:\n\n1. Open Cursor.ai and navigate to Settings > Features\n2. Look for \"MCP Servers\" in the features panel\n3. Add a new MCP server with the following configuration:\n - **Name**: `mongodb`\n - **Command**: `npx`\n - **Args**: `mongo-mcp mongodb://:@:/?authSource=admin`\n\n*Note: Cursor currently supports MCP tools only in the Agent in Composer feature.*\n\n### Test Sandbox Setup\n\nIf you don't have a MongoDB server to connect to and want to create a sample sandbox, follow these steps:\n\n1. Start MongoDB using Docker Compose:\n\n```bash\ndocker-compose up -d\n```\n\n2. Seed the database with test data:\n\n```bash\nnpm run seed\n```\n\n### Configure Claude Desktop\n\nAdd this configuration to your Claude Desktop config file:\n\n**MacOS**: `~/Library/Application\\ Support/Claude/claude_desktop_config.json` \n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n#### Local Development Mode:\n\n```json\n{\n \"mcpServers\": {\n \"mongodb\": {\n \"command\": \"node\",\n \"args\": [\n \"dist/index.js\",\n \"mongodb://root:example@localhost:27017/test?authSource=admin\"\n ]\n }\n }\n}\n```\n\n### Test Sandbox Data Structure\n\nThe seed script creates three collections with sample data:\n\n#### Users\n\n- Personal info (name, email, age)\n- Nested address with coordinates\n- Arrays of interests\n- Membership dates\n\n#### Products\n\n- Product details (name, SKU, category)\n- Nested specifications\n- Price and inventory info\n- Tags and ratings\n\n#### Orders\n\n- Order details with items\n- User references\n- Shipping and payment info\n- Status tracking\n\n## 🎯 Example Prompts\n\nTry these prompts with Claude to explore the functionality:\n\n### Basic Operations\n\n```\n\"What collections are available in the database?\"\n\"Show me the schema for the users collection\"\n\"Find all users in San Francisco\"\n```\n\n### Advanced Queries\n\n```\n\"Find all electronics products that are in stock and cost less than $1000\"\n\"Show me all orders from the user john@example.com\"\n\"List the products with ratings above 4.5\"\n```\n\n### Index Management\n\n```\n\"What indexes exist on the users collection?\"\n\"Create an index on the products collection for the 'category' field\"\n\"List all indexes across all collections\"\n```\n\n### Document Operations\n\n```\n\"Insert a new product with name 'Gaming Laptop' in the products collection\"\n\"Update the status of order with ID X to 'shipped'\"\n\"Find and delete all products that are out of stock\"\n```\n\n## 📝 Available Tools\n\nThe server provides these tools for database interaction:\n\n### Query Tools\n\n- `listCollections`: Lists available collections in the database\n- `find`: Queries documents with filtering and projection\n- `insertOne`: Inserts a single document into a collection\n- `updateOne`: Updates a single document in a collection\n- `deleteOne`: Deletes a single document from a collection\n\n### Index Tools\n\n- `createIndex`: Creates a new index on a collection\n- `dropIndex`: Removes an index from a collection\n- `indexes`: Lists indexes for a collection\n\n## 🛠️ Development\n\nThis project is built with:\n\n- TypeScript for type-safe development\n- MongoDB Node.js driver for database operations\n- Zod for schema validation\n- Model Context Protocol SDK for server implementation\n\nTo set up the development environment:\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm test\n```\n\n## 🔒 Security Considerations\n\nWhen using this MCP server with your MongoDB database:\n\n1. **Create a dedicated MongoDB user** with minimal permissions needed for your use case\n2. **Never use admin credentials** in production environments\n3. **Enable access logging** for audit purposes\n4. **Set appropriate read/write permissions** on collections\n5. **Use connection string parameters** to restrict access (e.g., `readPreference=secondary`)\n6. **Consider IP allow-listing** to restrict database access\n\n⚠️ **IMPORTANT**: Always follow the principle of least privilege when configuring database access.\n\n## 🌐 How It Works\n\nThe MongoDB MCP server:\n\n1. Connects to your MongoDB database using the connection string provided\n2. Exposes MongoDB operations as tools that follow the MCP specification\n3. Validates inputs using Zod for type safety and security\n4. Executes queries and returns structured data to the LLM client\n5. Manages connection pooling and proper error handling\n\nAll operations are executed with proper validation to prevent security issues such as injection attacks.\n\n## 📦 Deployment\n\nYou can deploy this MCP server in several ways:\n\n- Locally via npx (as shown in Quick Start)\n- As a global npm package: `npm install -g @coderay/mongo-mcp-server`\n- In a Docker container (see Dockerfile in the repository)\n- As a service on platforms like Heroku, Vercel, or AWS\n\n## ❓ Troubleshooting\n\n### Common Issues\n\n1. **Connection Errors**\n - Verify your MongoDB connection string is correct\n - Check that your MongoDB server is running and accessible\n - Ensure network permissions allow the connection\n\n2. **Authentication Issues**\n - Confirm username and password are correct\n - Verify the authentication database is specified (usually `authSource=admin`)\n - Check if MongoDB requires TLS/SSL connections\n\n3. **Tool Execution Problems**\n - Restart Claude Desktop or Cursor.ai completely\n - Check the logs for detailed error messages:\n ```bash\n # macOS\n tail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n ```\n\n4. **Performance Issues**\n - Consider adding appropriate indexes to frequently queried fields\n - Use projection to limit the data returned in queries\n - Use limit and skip parameters for pagination\n\n### Getting Help\n\nIf you encounter issues:\n- Review the [MCP Documentation](https://modelcontextprotocol.io)\n- Submit an issue on our [GitHub repository](https://github.com/1rb/mongo-mcp/issues)\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ","url","https://github.com/1RB/mongo-mcp","githubRepository",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":103,"_107":108,"_109":-5,"_110":108},"defaultBranch","main","fullName","1RB/mongo-mcp","githubTreeId",80153,"language","TypeScript","owner",{"_104":105,"_106":31},"login","1RB","verified","recentStargazers",2,"spdxLicense","stargazers","id",1569,"inspectable","name","MongoDB MCP Server","npmPackage",{"_114":118,"_119":120},"@coderay/mongodb-mcp-server","weeklyDownloads",168,"prompts","redditPostForeignId","1j6w1pd","relatedMcpServerIds",[126,127,128,129,130,131],1457,259,260,355,958,1113,"resources","scores",{"_135":136,"_137":-5,"_138":-5},"license",0,"quality","security","simpleIcon","supportedPlatforms",[142,143,144],"WINDOWS","LINUX","MACOS","tools","7w2bcv6rg0","updatedAt",["D",1741795720953],"meta",[151,154,156,163,166,168,171,174,177,180,183,185,188,191,193,195,197,199,201],{"_152":153},"title","MongoDB MCP Server | Glama",{"_155":84,"_114":75},"content",{"_157":158,"_159":160,"_161":162},"href","https://glama.ai/mcp/servers/7w2bcv6rg0","rel","canonical","tagName","link",{"_155":115,"_164":165},"property","og:title",{"_155":84,"_164":167},"og:description",{"_155":169,"_164":170},"https://glama.ai/logo.png","og:logo",{"_155":172,"_164":173},"https://glama.ai/mcp/servers/7w2bcv6rg0/og-image","og:image",{"_155":175,"_164":176},"630","og:image:height",{"_155":178,"_164":179},"1200","og:image:width",{"_155":181,"_164":182},"website","og:type",{"_155":158,"_164":184},"og:url",{"_155":186,"_164":187},"ChatGPT alternative for power users","og:site_name",{"_155":189,"_114":190},"summary_large_image","twitter:card",{"_155":186,"_114":192},"twitter:title",{"_155":84,"_114":194},"twitter:description",{"_155":172,"_114":196},"twitter:image",{"_155":175,"_114":198},"twitter:image:height",{"_155":178,"_114":200},"twitter:image:width",{"_202":203},"script:ld+json",{"_204":205,"_206":207},"@context","http://schema.org","@graph",[208],{"_204":209,"_210":211,"_212":213},"https://schema.org","@type","BreadcrumbList","itemListElement",[214,221,224,228],{"_210":215,"_216":217,"_114":218,"_219":220},"ListItem","item","https://glama.ai/","Glama","position",1,{"_210":215,"_216":222,"_114":223,"_219":108},"https://glama.ai/mcp","MCP",{"_210":215,"_216":225,"_114":226,"_219":227},"https://glama.ai/mcp/servers","Servers",3,{"_210":215,"_216":158,"_114":115,"_219":229},4,"routes/_public/mcp/servers/~uid/_pages/reviews/_route",{"_59":-5,"_60":232,"_149":247,"_281":-5},{"_62":233,"_64":234,"_42":238,"_83":84,"_85":84,"_86":239,"_92":240,"_111":112,"_113":31,"_114":115,"_116":242,"_121":-5,"_122":123,"_124":243,"_132":-5,"_133":244,"_139":-5,"_140":245,"_145":-5,"_46":146,"_147":246},["D",1741480365238],{"_66":67,"_68":235,"_71":236},[70],{"_70":237},{"_66":74,"_75":76},[78,79,80,81,82],{"_88":89,"_90":91},{"_94":95,"_96":97,"_98":99,"_100":101,"_102":241,"_107":108,"_109":-5,"_110":108},{"_104":105,"_106":31},{"_114":118,"_119":120},[126,127,128,129,130,131],{"_135":136,"_137":-5,"_138":-5},[142,143,144],["D",1741795720953],[248,250,251,253,255,256,257,258,259,260,261,262,263,264,265,266,267,268,269],{"_152":249},"Reviews | MongoDB MCP Server | Glama",{"_155":84,"_114":75},{"_157":252,"_159":160,"_161":162},"https://glama.ai/mcp/servers/7w2bcv6rg0/reviews",{"_155":254,"_164":165},"Reviews | MongoDB MCP Server",{"_155":84,"_164":167},{"_155":169,"_164":170},{"_155":172,"_164":173},{"_155":175,"_164":176},{"_155":178,"_164":179},{"_155":181,"_164":182},{"_155":252,"_164":184},{"_155":186,"_164":187},{"_155":189,"_114":190},{"_155":186,"_114":192},{"_155":84,"_114":194},{"_155":172,"_114":196},{"_155":175,"_114":198},{"_155":178,"_114":200},{"_202":270},{"_204":205,"_206":271},[272],{"_204":209,"_210":211,"_212":273},[274,275,276,277,278],{"_210":215,"_216":217,"_114":218,"_219":220},{"_210":215,"_216":222,"_114":223,"_219":108},{"_210":215,"_216":225,"_114":226,"_219":227},{"_210":215,"_216":158,"_114":115,"_219":229},{"_210":215,"_216":252,"_114":279,"_219":280},"Reviews",5,"review","actionData","errors"]

Rate & Review