{"_id":"@lglen/firebase-emulator-mcp","_rev":"4-220b220444b7850e455c981815f53d5c","name":"@lglen/firebase-emulator-mcp","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@lglen/firebase-emulator-mcp","version":"1.0.0","keywords":["firebase","emulator","mcp","modelcontextprotocol","ai","claude","copilot"],"license":"MIT","_id":"@lglen/firebase-emulator-mcp@1.0.0","maintainers":[{"name":"lglen","email":"lglenbe1@asu.edu"}],"homepage":"https://github.com/vaultnel/firebase-emulator-mcp#readme","bugs":{"url":"https://github.com/vaultnel/firebase-emulator-mcp/issues"},"bin":{"firebase-emulator-mcp":"lib/index.js"},"dist":{"shasum":"2de5263cd45ecadcf1ad5edaaa1954191abcb327","tarball":"https://registry.npmjs.org/@lglen/firebase-emulator-mcp/-/firebase-emulator-mcp-1.0.0.tgz","fileCount":7,"integrity":"sha512-obp79Gn68ZUhhSyMsaKOkX8JmkK7wqKfHOyt75T+ntFp/nCkKW7tVRxhKg1Q0D7a0NpLpWeJ/fIztGfiPW9OKQ==","signatures":[{"sig":"MEUCIQD8FSyVoEsxApuEWxu8wWN6UtcFnoYLoVjE6eV98qfl4AIgWBU5QQxdFbTO3vCNSGOUOUOOHUlSBOq7tpcB8imRzro=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31893},"main":"lib/index.js","type":"module","types":"lib/index.d.ts","engines":{"node":">=18"},"gitHead":"9f8873921f04ff36ce8703c79c3075e03253cb53","scripts":{"test":"node test.mjs","build":"tsc","start":"node lib/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"lglen","email":"lglenbe1@asu.edu"},"repository":{"url":"git+https://github.com/vaultnel/firebase-emulator-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server that exposes Firebase emulator data (Firestore, Auth, RTDB) to AI agents over stdio","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3","@types/node":"^26.1.0"},"_npmOperationalInternal":{"tmp":"tmp/firebase-emulator-mcp_1.0.0_1783314392899_0.36492137322275386","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@lglen/firebase-emulator-mcp","version":"1.0.1","keywords":["firebase","emulator","mcp","modelcontextprotocol","ai","claude","copilot"],"license":"MIT","_id":"@lglen/firebase-emulator-mcp@1.0.1","maintainers":[{"name":"lglen","email":"lglenbe1@asu.edu"}],"homepage":"https://github.com/vaultnel/firebase-emulator-mcp#readme","bugs":{"url":"https://github.com/vaultnel/firebase-emulator-mcp/issues"},"bin":{"firebase-emulator-mcp":"lib/index.js"},"dist":{"shasum":"65b5aedf8d2909d024db55300985329ebd6dc21d","tarball":"https://registry.npmjs.org/@lglen/firebase-emulator-mcp/-/firebase-emulator-mcp-1.0.1.tgz","fileCount":7,"integrity":"sha512-pFZE0YSxRW7TzqyijYATzzA0/Ebo4PXPml65baK2gbfflGpzYbykT3w45XT9SG2o4C54RQq0WI1XvsutfVNKNQ==","signatures":[{"sig":"MEYCIQClHj/KD4mP9RFBo4bzfyQsYQ3F+kpHfIQR4LkBIokDFQIhAKOaBwNzAPvhtx9H22EKlQ/JjgPmfsa6HvSWoriVtCK8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32196},"main":"lib/index.js","type":"module","types":"lib/index.d.ts","engines":{"node":">=18"},"gitHead":"9f8873921f04ff36ce8703c79c3075e03253cb53","scripts":{"test":"node test.mjs","build":"tsc","start":"node lib/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"lglen","email":"lglenbe1@asu.edu"},"repository":{"url":"git+https://github.com/vaultnel/firebase-emulator-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server that exposes Firebase emulator data (Firestore, Auth, RTDB) to AI agents over stdio","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3","@types/node":"^26.1.0"},"_npmOperationalInternal":{"tmp":"tmp/firebase-emulator-mcp_1.0.1_1783315808629_0.3784098873879873","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@lglen/firebase-emulator-mcp","version":"1.0.2","keywords":["firebase","emulator","mcp","modelcontextprotocol","ai","claude","copilot"],"license":"MIT","_id":"@lglen/firebase-emulator-mcp@1.0.2","maintainers":[{"name":"lglen","email":"lglenbe1@asu.edu"}],"homepage":"https://github.com/vaultnel/firebase-emulator-mcp#readme","bugs":{"url":"https://github.com/vaultnel/firebase-emulator-mcp/issues"},"bin":{"firebase-emulator-mcp":"lib/index.js"},"dist":{"shasum":"5f86173f36822b62b52b69e643f7bc406b865c10","tarball":"https://registry.npmjs.org/@lglen/firebase-emulator-mcp/-/firebase-emulator-mcp-1.0.2.tgz","fileCount":7,"integrity":"sha512-qZJ8d0EIklIjtIPl7lYZvEOQvqi+P5+wzgkOR9K9iMqAQ/QhqGfys3FIH1rbUS9kb+/WtMJfpqrMcWpaVjWyaQ==","signatures":[{"sig":"MEUCIAjvy30WEc8qM5Bf4TqgTpLhvUeRga6wbqDm7qazruGwAiEAqkYhFY5OgnOxrUUm36ZWrWdoPhqRfMcuI/T3G19yDTo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32237},"main":"lib/index.js","type":"module","types":"lib/index.d.ts","engines":{"node":">=18"},"gitHead":"9f8873921f04ff36ce8703c79c3075e03253cb53","scripts":{"test":"node test.mjs","build":"tsc","start":"node lib/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"lglen","email":"lglenbe1@asu.edu"},"repository":{"url":"git+https://github.com/vaultnel/firebase-emulator-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server that exposes Firebase emulator data (Firestore, Auth, RTDB) to AI agents over stdio","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3","@types/node":"^26.1.0"},"_npmOperationalInternal":{"tmp":"tmp/firebase-emulator-mcp_1.0.2_1783316344595_0.053808288559846096","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@lglen/firebase-emulator-mcp","version":"1.0.3","description":"MCP server that exposes Firebase emulator data (Firestore, Auth, RTDB) to AI agents over stdio","type":"module","main":"lib/index.js","types":"lib/index.d.ts","bin":{"firebase-emulator-mcp":"lib/index.js"},"scripts":{"build":"tsc","build:watch":"tsc --watch","prepublishOnly":"npm run build","start":"node lib/index.js","test":"node test.mjs"},"keywords":["firebase","emulator","mcp","modelcontextprotocol","ai","claude","copilot"],"repository":{"type":"git","url":"git+https://github.com/vaultnel/firebase-emulator-mcp.git"},"license":"MIT","engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^26.1.0","typescript":"^6.0.3"},"_id":"@lglen/firebase-emulator-mcp@1.0.3","gitHead":"5921b84fbc9b6a0f2287f48a66254bb815083cd0","bugs":{"url":"https://github.com/vaultnel/firebase-emulator-mcp/issues"},"homepage":"https://github.com/vaultnel/firebase-emulator-mcp#readme","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-dR8wLI9HnvP5taMqRPhg0ZXQrqE3Pstuz26OyYL3dGHPSfFQbqZAB0CR+0lGI/mpAQCdaLA/G5rKQ3HO62M47w==","shasum":"322aab7fdf1fa484d6a7feab6d42b39c81585b0b","tarball":"https://registry.npmjs.org/@lglen/firebase-emulator-mcp/-/firebase-emulator-mcp-1.0.3.tgz","fileCount":7,"unpackedSize":32428,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD+N0IJfpTYvC8+kSquPhkVGkL+H00qoaHDsuv0LHsH8AIgCnlPMpltrmBVhlGLjfg2zniyVpsHf5A9f92j71EbVwM="}]},"_npmUser":{"name":"lglen","email":"lglenbe1@asu.edu"},"directories":{},"maintainers":[{"name":"lglen","email":"lglenbe1@asu.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/firebase-emulator-mcp_1.0.3_1783377767558_0.16816147555461458"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-06T05:06:32.698Z","modified":"2026-07-06T22:42:47.828Z","1.0.0":"2026-07-06T05:06:33.026Z","1.0.1":"2026-07-06T05:30:08.753Z","1.0.2":"2026-07-06T05:39:04.742Z","1.0.3":"2026-07-06T22:42:47.735Z"},"bugs":{"url":"https://github.com/vaultnel/firebase-emulator-mcp/issues"},"license":"MIT","homepage":"https://github.com/vaultnel/firebase-emulator-mcp#readme","keywords":["firebase","emulator","mcp","modelcontextprotocol","ai","claude","copilot"],"repository":{"type":"git","url":"git+https://github.com/vaultnel/firebase-emulator-mcp.git"},"description":"MCP server that exposes Firebase emulator data (Firestore, Auth, RTDB) to AI agents over stdio","maintainers":[{"name":"lglen","email":"lglenbe1@asu.edu"}],"readme":"# Firebase Emulator MCP Server\n[![GitHub](https://img.shields.io/badge/GitHub-firebase--emulator--mcp-181717?&logo=github)](https://github.com/LaishGlenberg)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that exposes Firebase\nemulator data — Firestore, Auth, Logs, and Realtime Database — to AI agents over stdio.\n\nDesigned for local development workflows where AI coding assistants (Claude Code, GitHub\nCopilot, etc.) need to inspect emulator state without leaving the editor.\n\nCreated by [Laish Glenberg](https://www.linkedin.com/in/laish-glenberg/), please drop a star on the repo if this package helped you!\n\n---\n\n## Features\n\n| Tool | Description |\n|---|---|\n| `emulator_status` | Ping all emulators and report reachability |\n| `firestore_list_collections` | List root-level collection IDs |\n| `firestore_query` | Query documents with optional field filters (`==`, `>=`, `<=`, `in`, etc.) |\n| `firestore_get` | Fetch a single document by path (e.g. `Member/abc123`) |\n| `rtdb_get` | Read any path from the Realtime Database emulator |\n| `auth_list_users` | List Firebase Auth users |\n| `auth_get_user` | Look up a user by email or localId |\n| `emulator_logs` | Stream recent log entries from the emulator hub WebSocket |\n\n---\n\n## Prerequisites\n\n- **Node.js 18+** (native `fetch` and `WebSocket` — v21+ recommended)\n- **Firebase emulators** running locally — start from your project root:\n\n  ```bash\n  firebase emulators:start\n  ```\n\n  The server connects to the default emulator ports:\n  - Firestore: `8080`\n  - Auth: `9099`\n  - Realtime Database: `9000`\n  - Hub (logs): `4500`\n\n---\n\n## Install & Run\n\n### Via npm (recommended)\n\n```bash\nnpm install -g firebase-emulator-mcp\nfirebase-emulator-mcp\n```\n\n---\n\n## VS Code / MCP Client Setup\n\nAdd to your project's `.vscode/mcp.json` or VS Code user settings:\n\n```json\n{\n  \"servers\": {\n    \"firebase-emulator\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\"./mcp-server/lib/index.js\"],\n      \"env\": {\n        \"FIREBASE_PROJECT_ID\": \"<proj_id>\",\n        \"FIREBASE_RTDB_NAMESPACE\": \"<proj_id>-default-rtdb\"\n      }\n    }\n  }\n}\n```\n\nOr if installed globally:\n\n```json\n{\n  \"servers\": {\n    \"firebase-emulator\": {\n      \"type\": \"stdio\",\n      \"command\": \"firebase-emulator-mcp\",\n      \"env\": {\n        \"FIREBASE_PROJECT_ID\": \"<proj_id>\",\n        \"FIREBASE_RTDB_NAMESPACE\": \"<proj_id>-default-rtdb\"\n      }\n    }\n  }\n}\n```\n\nOptionally can skip install and run directly through npx\n\n```json\n{\n  \"servers\": {\n    \"firebase-emulator\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"@lglen/firebase-emulator-mcp\"],\n      \"env\": {\n        \"FIREBASE_PROJECT_ID\": \"<proj_id>\",\n        \"FIREBASE_RTDB_NAMESPACE\": \"<proj_id>-default-rtdb\"\n      }\n    }\n  }\n}\n```\n\nFor Claude Code or other MCP clients, use the same stdio configuration.\n\n---\n\n### Project structure\n\n```\nmcp-server/\n├── src/\n│   └── index.ts          # TypeScript source (all tools)\n├── lib/                   # Compiled output (git-ignored)\n├── test.mjs              # Smoke test runner\n├── tsconfig.json\n├── package.json\n├── .gitignore\n├── LICENSE               # MIT\n└── README.md\n```\n\n---\n\n## Configuration\n\nDefault emulator ports are defined in `src/index.ts` under the `EMULATORS` constant.\nEdit them to match your `firebase.json` if you use non-standard ports:\n\n| Service     | Default Port |\n|-------------|--------------|\n| Firestore   | 8080         |\n| Auth        | 9099         |\n| Realtime DB | 9000         |\n| Storage     | 9199         |\n| Emulator UI | 4000         |\n| Hub (logs)  | 4500         |\n\n---\n\n## License\n\nMIT\n\n## Author\n\nCheck me out on [GitHub](https://github.com/LaishGlenberg)","readmeFilename":"README.md"}