{"id":50553391,"url":"https://github.com/mqlens/mqlens-mongodb","last_synced_at":"2026-06-12T10:01:00.544Z","repository":{"id":361693234,"uuid":"1253838600","full_name":"mqlens/mqlens-mongodb","owner":"mqlens","description":"Free, native MongoDB GUI with the power of paid tools — every auth mode, TLS/SSH/proxy, aggregation + explain plans, bulk edit, schema analysis, GridFS, embedded mongosh, AI query assistant. Encrypted, zero telemetry. Tauri + React. Apache-2.0.","archived":false,"fork":false,"pushed_at":"2026-06-11T14:43:36.000Z","size":24390,"stargazers_count":33,"open_issues_count":14,"forks_count":1,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2026-06-11T15:27:07.827Z","etag":null,"topics":["cross-platform","database-gui","desktop-app","devtools","mongodb","mongodb-client","mongodb-gui","mongosh","react","rust","tauri"],"latest_commit_sha":null,"homepage":"https://mqlens.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mqlens.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-29T21:37:45.000Z","updated_at":"2026-06-11T14:41:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mqlens/mqlens-mongodb","commit_stats":null,"previous_names":["mqlens/mqlens-mongodb"],"tags_count":56,"template":false,"template_full_name":null,"purl":"pkg:github/mqlens/mqlens-mongodb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mqlens%2Fmqlens-mongodb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mqlens%2Fmqlens-mongodb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mqlens%2Fmqlens-mongodb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mqlens%2Fmqlens-mongodb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mqlens","download_url":"https://codeload.github.com/mqlens/mqlens-mongodb/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mqlens%2Fmqlens-mongodb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34238714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cross-platform","database-gui","desktop-app","devtools","mongodb","mongodb-client","mongodb-gui","mongosh","react","rust","tauri"],"created_at":"2026-06-04T05:00:35.503Z","updated_at":"2026-06-12T10:01:00.539Z","avatar_url":"https://github.com/mqlens.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MQLens\n\n[![CI](https://github.com/mqlens/mqlens-mongodb/actions/workflows/ci.yml/badge.svg)](https://github.com/mqlens/mqlens-mongodb/actions/workflows/ci.yml)\n[![Coverage](https://img.shields.io/badge/coverage-enabled-brightgreen.svg)](.github/workflows/ci.yml)\n[![Latest release](https://img.shields.io/github/v/release/mqlens/mqlens-mongodb)](https://github.com/mqlens/mqlens-mongodb/releases)\n[![Downloads](https://img.shields.io/github/downloads/mqlens/mqlens-mongodb/total)](https://github.com/mqlens/mqlens-mongodb/releases)\n[![Stars](https://img.shields.io/github/stars/mqlens/mqlens-mongodb?style=flat)](https://github.com/mqlens/mqlens-mongodb/stargazers)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n\n**A fast, native desktop GUI for MongoDB** — built with [Tauri](https://tauri.app)\n(Rust) and React + TypeScript.\n\n🌐 Website: **[mqlens.com](https://mqlens.com)**\n\nMQLens lets you connect to real MongoDB deployments, browse your data, run\nqueries and aggregations, manage indexes and views, and inspect what your\nqueries actually do — from a single cross-platform desktop app.\n\n\u003e **In short:** point MQLens at any MongoDB (with TLS / SSH / proxy and every\n\u003e auth mechanism), then browse, query, aggregate, explain, edit in bulk, manage\n\u003e indexes and views, analyze schemas, browse GridFS, and run an embedded\n\u003e `mongosh` — with credentials encrypted behind a master password.\n\n## Demo\n\n![MQLens demo: connect to MongoDB, run a find, build an aggregation, and read an explain plan](assets/demo.gif)\n\n## Screenshots\n\n[![MQLens browsing MongoDB documents](website/public/screenshots/mqlens-documents.png)](website/public/screenshots/mqlens-documents.png)\n\n| Query tools | GridFS |\n| --- | --- |\n| [![MQLens visual query builder](website/public/screenshots/mqlens-visual-builder.png)](website/public/screenshots/mqlens-visual-builder.png) | [![MQLens GridFS browser](website/public/screenshots/mqlens-gridfs.png)](website/public/screenshots/mqlens-gridfs.png) |\n\n## Features\n\n- **Connections** — standalone, replica set, or raw connection string; TLS\n  (system CA, custom CA file, client certificate), SSH tunnel, and SOCKS5 proxy;\n  configurable connect / server-selection timeouts. A staged \"Test Connection\"\n  reports each real phase (parse → DNS resolve → connect → ping).\n- **Authentication** — SCRAM-SHA-1/256, X.509, `MONGODB-AWS` (IAM, incl. session\n  token), GSSAPI/Kerberos, and LDAP (PLAIN), with the correct `$external`\n  plumbing.\n- **Browse** — databases, collections, views, GridFS buckets, and system\n  collections in a tree.\n- **Query** — `find` with filter / sort / projection / skip / limit and\n  pagination; a visual query builder; full **aggregation pipelines**; and\n  **explain plans** (find *and* full-pipeline aggregate) with a visual plan tree.\n- **Documents** — view, insert, edit, and delete; **bulk** update-many /\n  delete-many by filter with a counted, guarded confirmation.\n- **Indexes** — create, inspect (real key pattern + unique/sparse), and drop.\n- **Collections \u0026 views** — create / drop / rename collections and databases;\n  create aggregation-backed **views**.\n- **Schema analysis** — sample a collection and see per-field types and presence\n  / coverage (including nested paths).\n- **GridFS** — browse files in a bucket and download them to disk.\n- **Import / export** — JSON and CSV, including full-collection background\n  exports.\n- **mongosh shell** — an embedded shell backed by a real `mongosh` binary.\n- **AI query assistant** — natural-language → MQL generation, with multiple\n  providers (Anthropic / OpenAI / Gemini and local agent CLIs); the API key\n  stays in the backend.\n- **Encrypted credentials** — a master password gates the app; connection\n  profiles and settings are encrypted at rest with AES-256-GCM (Argon2id key\n  derivation).\n\n## Install\n\nGrab the latest build for your OS from\n**[Releases](https://github.com/mqlens/mqlens-mongodb/releases/latest)**:\n\n- **macOS** — download the `.dmg` (Apple-notarized; Touch ID unlock supported).\n- **Windows** — download the `.msi` or `.exe` (signed via Azure Trusted Signing).\n- **Linux** — download the `.AppImage` (`chmod +x` and run) or install the `.deb`.\n\nNo account, no sign-up, no telemetry.\n\n## Trust \u0026 privacy\n\n- **No telemetry** — nothing is tracked or phoned home.\n- **No account required** — just download and connect.\n- **Credentials encrypted locally** with AES-256-GCM and Argon2id key derivation.\n- **Signed release assets** (detached signatures on every artifact).\n- **macOS notarized** builds and **Windows signed** installers.\n- **Apache-2.0** — fully open source.\n\n## MQLens vs. the alternatives\n\n| | MQLens | Compass | Studio 3T |\n|---|---|---|---|\n| Price | **Free (Apache-2.0)** | Free | Paid |\n| Engine | **Native (Tauri/Rust)** | Electron | Java |\n| Enterprise auth (X.509 / AWS / Kerberos / LDAP) | ✅ | ✅ | ✅ |\n| SSH tunnel | ✅ | ✅ | ✅ |\n| SOCKS5 proxy | ✅ | Not clearly exposed | Varies |\n| Aggregation + explain tree | ✅ | ✅ | ✅ |\n| Embedded `mongosh` | ✅ | ✅ | ✅ |\n| AI query assistant (bring-your-own key) | ✅ | ✅ | partial |\n| Biometric-unlocked encrypted vault | ✅ | ❌ | partial |\n| Telemetry | **None** | yes | yes |\n\n*Comparison reflects publicly documented behavior at time of writing; tools change — corrections welcome via an issue.*\n\n## Tech stack\n\n- **Frontend:** React 19 + TypeScript, Vite, Tailwind-style utility CSS.\n- **Backend:** Rust, Tauri v2, the official `mongodb` driver.\n- **Tests:** Vitest + Testing Library (frontend), `cargo test` (backend).\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) 18+\n- [Rust](https://www.rust-lang.org/tools/install) (stable) and the\n  [Tauri prerequisites](https://tauri.app/start/prerequisites/) for your OS\n- [`mongosh`](https://www.mongodb.com/docs/mongodb-shell/) on your `PATH` (only\n  needed for the embedded shell)\n\n## Development\n\n```bash\nnpm install\nnpm run tauri dev      # run the desktop app with hot reload\n```\n\nOther useful commands:\n\n```bash\nnpm run dev            # frontend only (browser, no Tauri APIs)\nnpm test               # frontend tests (Vitest)\nnpm run coverage:frontend   # frontend tests with coverage\ncargo test --manifest-path src-tauri/Cargo.toml   # backend tests\ncargo llvm-cov --manifest-path src-tauri/Cargo.toml --summary-only --ignore-filename-regex 'src-tauri/src/(lib|main)\\.rs'   # backend coverage\nnpm run build          # type-check + build the frontend bundle\n```\n\nThe backend integration tests (and the coverage figure CI reports) need a real\nMongoDB. They skip automatically when `MQLENS_TEST_MONGO_URI` is unset, so set it\nto exercise the live database paths:\n\n```bash\ndocker run -d -p 27017:27017 mongo:7\nMQLENS_TEST_MONGO_URI=mongodb://localhost:27017 \\\n  cargo llvm-cov --manifest-path src-tauri/Cargo.toml --summary-only --ignore-filename-regex 'src-tauri/src/(lib|main)\\.rs'\n```\n\n## Build\n\n```bash\nnpm run tauri build    # produce a platform installer / bundle\n```\n\n## Security\n\n- Connection credentials and settings are encrypted at rest behind a master\n  password; nothing is stored in plaintext once the vault is initialized.\n- Disabling TLS certificate validation is an explicit, opt-in choice (with an\n  in-app warning), never silent.\n- AI provider API keys are held in the backend, out of the frontend bundle.\n\n\u003e MQLens talks directly to whatever MongoDB deployment you point it at. Use the\n\u003e usual care with production credentials.\n\n## Verifying downloads\n\nEvery release asset is shipped with a detached GPG signature (`.asc`), and the\nmacOS bundles are also Apple-notarized. To verify a download:\n\n```bash\n# Import the MQLens release public key (once):\ngpg --import KEYS          # from this repo, or: curl -L https://mqlens.com/KEYS | gpg --import\n\n# Verify an asset against its .asc:\ngpg --verify MQLens_0.1.0_amd64.deb.asc MQLens_0.1.0_amd64.deb\n```\n\nSigning key — **MQLens Releases `\u003cdev@mqlens.com\u003e`**, fingerprint:\n\n```\n8E10 C09D 1FEC 8C8F 90B1  DB7E 5804 6649 06E7 D373\n```\n\n## License\n\nLicensed under the [Apache License 2.0](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmqlens%2Fmqlens-mongodb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmqlens%2Fmqlens-mongodb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmqlens%2Fmqlens-mongodb/lists"}