{
  "markdown": "# MongoDB Gemini CLI Extension\n\nA Gemini CLI extension that provides MongoDB database and Atlas operations through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).\n\nThis extension wraps the official [`mongodb-mcp-server`](https://github.com/mongodb-js/mongodb-mcp-server) npm package, providing seamless installation for Gemini CLI users with automatic upstream updates.\n\n## Installation\n\n### Deploy script (recommended)\n\n```bash\ngit clone https://github.com/mongodb-partners/mongodb-gemini-extension.git\ncd mongodb-gemini-extension\n./deploy-mongodb-gemini-extension.sh\n```\n\nThe script checks prerequisites, installs the extension to `~/.gemini/extensions/mongodb/`, and prompts for your MongoDB connection string.\n\nPass the URI directly for non-interactive use:\n\n```bash\n./deploy-mongodb-gemini-extension.sh --uri \"mongodb+srv://user:pass@cluster.mongodb.net/mydb\"\n```\n\n### Install from GitHub\n\n```bash\ngemini extensions install https://github.com/mongodb-partners/mongodb-gemini-extension.git\n```\n\n### Manual installation\n\n```bash\ngit clone https://github.com/mongodb-partners/mongodb-gemini-extension.git\ncd mongodb-gemini-extension\nnpm install\nmkdir -p ~/.gemini/extensions\ncp -R . ~/.gemini/extensions/mongodb\n```\n\n## Quick start\n\n1. Copy the configuration template:\n\n   ```bash\n   cd ~/.gemini/extensions/mongodb\n   cp mongo.config.json.example mongo.config.json\n   ```\n\n2. Add your MongoDB connection string to `mongo.config.json`:\n\n   ```json\n   {\n     \"MONGODB_URI\": \"mongodb+srv://user:pass@cluster.mongodb.net/mydb\"\n   }\n   ```\n\n3. Restart the Gemini CLI and verify:\n\n   ```\n   /mcp\n   /tools\n   ```\n\n   The MongoDB server and its tools appear in the output.\n\n> **Security:** `mongo.config.json` contains credentials and is excluded from version control via `.gitignore`. Do not commit this file.\n\n## Features\n\n- **MongoDB CRUD** — find, aggregate, insert, update, delete operations on collections\n- **Schema and index management** — create/drop indexes, infer collection schemas, view stats\n- **Atlas cluster management** — list orgs/projects, create clusters, manage users and access lists\n- **Atlas Search** — create and list Atlas Search indexes\n- **Local deployments** — create local Atlas deployments via Docker\n- **Data export** — export query results to EJSON\n- **Read-only mode** — restrict the extension to read operations\n- **Automatic updates** — weekly CI checks for new `mongodb-mcp-server` releases\n\n## Tools\n\nAll tools come from the upstream [MongoDB MCP Server](https://github.com/mongodb-js/mongodb-mcp-server). The available set depends on the installed version.\n\n### Database tools\n\n| Tool | Description |\n|------|-------------|\n| `find` | Run a find query against a collection |\n| `aggregate` | Run an aggregation pipeline |\n| `count` | Count documents in a collection |\n| `insert-one` | Insert a single document |\n| `insert-many` | Insert multiple documents |\n| `update-one` | Update a single document |\n| `update-many` | Update multiple documents |\n| `delete-one` | Delete a single document |\n| `delete-many` | Delete multiple documents |\n| `create-index` | Create an index on a collection |\n| `drop-index` | Drop an index from a collection |\n| `rename-collection` | Rename a collection |\n| `drop-collection` | Drop a collection |\n| `drop-database` | Drop a database |\n| `list-databases` | List all databases |\n| `list-collections` | List collections in a database |\n| `collection-indexes` | List indexes on a collection |\n| `collection-schema` | Infer the schema of a collection |\n| `collection-storage-size` | Get collection size in MB |\n| `db-stats` | Get database statistics |\n| `export` | Export query results to EJSON |\n| `explain` | Explain a query execution plan |\n\n### Atlas tools\n\nRequires `MDB_MCP_API_CLIENT_ID` and `MDB_MCP_API_CLIENT_SECRET` in your configuration. See the [configuration reference](docs/configuration.md).\n\n| Tool | Description |\n|------|-------------|\n| `atlas-list-orgs` | List Atlas organizations |\n| `atlas-list-projects` | List Atlas projects |\n| `atlas-create-project` | Create an Atlas project |\n| `atlas-list-clusters` | List Atlas clusters |\n| `atlas-inspect-cluster` | Inspect a specific cluster |\n| `atlas-create-free-cluster` | Create a free-tier cluster |\n| `atlas-connect-cluster` | Connect to an Atlas cluster |\n| `atlas-inspect-access-list` | Inspect IP/CIDR access list |\n| `atlas-create-access-list` | Add IP/CIDR to access list |\n| `atlas-list-db-users` | List database users |\n| `atlas-create-db-user` | Create a database user |\n| `atlas-list-alerts` | List project alerts |\n\n### Local deployment tools\n\n| Tool | Description |\n|------|-------------|\n| `atlas-local-create-deployment` | Create a local Atlas deployment via Docker |\n\n### Search index tools\n\n| Tool | Description |\n|------|-------------|\n| `create-search-index` | Create an Atlas Search index |\n| `list-search-indexes` | List search indexes on a collection |\n\nRun `/tools` in Gemini CLI to see the tools available with your installed version.\n\n## Resources\n\n| Resource | Description |\n|----------|-------------|\n| `config` | Server configuration (sensitive values redacted) |\n| `debug` | Debugging info for connectivity issues |\n| `exported-data` | Data exported via the `export` tool |\n\n## Updating\n\n### Automatic\n\nA GitHub Actions workflow (`.github/workflows/sync-upstream.yml`) runs weekly. When a new `mongodb-mcp-server` version is published, it creates a pull request with the updated dependency.\n\n### Manual\n\n```bash\ncd ~/.gemini/extensions/mongodb\nnpm install mongodb-mcp-server@latest\n```\n\nCheck the installed version:\n\n```bash\nnpm list mongodb-mcp-server\n```\n\nRestart the Gemini CLI after updating.\n\n## Documentation\n\n- [Configuration reference](docs/configuration.md) — all config options and examples\n- [Architecture](docs/architecture.md) — how the extension works and why\n- [Developer guide](docs/developer-guide.md) — setup, testing, and contributing\n- [Troubleshooting](docs/troubleshooting.md) — common errors and fixes\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE).\n\n## Links\n\n- [MongoDB MCP Server (upstream)](https://github.com/mongodb-js/mongodb-mcp-server)\n- [MongoDB MCP Server on npm](https://www.npmjs.com/package/mongodb-mcp-server)\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- [MongoDB documentation](https://docs.mongodb.com/)\n- [MongoDB Atlas](https://www.mongodb.com/atlas)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n",
  "bytes": 6456,
  "sha": "f3d3dedb69819557ead8776fcd05627e511d3a25b54f74b10021fd7d8e7c2cc7",
  "repo_slug": "mongodb-partners/mongodb-gemini-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mongodb_partners_mongodb_gemini_extensio_73d827bd/readme"
}