v1.4.9

[1.4.9] 2025-05-10

Fixed

• fix: monkey-patch firebase-sdk - implement stdout filtering in Firestore client to prevent debug output interference

What's Changed

Full Changelog: v1.4.8...v1.4.9

v1.4.8

[1.4.5] - [1.4.9] 2025-05-09

Fixed

• fix: update error handling in Firestore client tests to return structured JSON error messages
• fix: enhance Firestore client error handling and ensure proper initialization of Firebase admin instance
• Improve Firestore collections listing by ensuring safe object creation and logging
• Changed response type assertion from 'json' to 'text' in Firestore client tests
• Improved Firestore collection listing with enhanced logging and response structure
• Updated version to 1.4.5 in package.json and package-lock.json
• Changed response type from 'json' to 'text' for Firestore collection operations

[1.4.2] - 2025-05-08

Fixed

• Fixed critical JSON parsing error in firestore_list_collections tool
• Added proper try/catch block to handle errors in collection listing
• Enhanced error reporting for Firestore collection operations
• Improved debug logging for collection listing operations

[1.4.1] - 2025-05-08

Fixed

• Fixed JSON parsing errors in tool responses by implementing consistent response formatting
• Enhanced all tool handlers to use explicit JSON sanitization with JSON.stringify()
• Added detailed debug logging for all tool responses to aid in troubleshooting
• Ensured consistent use of type: 'text' for all content responses
• Improved error handling and response formatting across all tools

[1.4.0] - 2025-05-08

Added

• Added streamable HTTP transport support as an alternative to stdio transport
• Implemented HTTP server transport with Express for handling MCP requests
• Added configuration options for HTTP port and host settings
• Enhanced logger utility with file logging capabilities
• Added support for debug log files with configurable paths
• Added environment variable support through dotenv integration
• Added comprehensive tests for HTTP transport functionality

Changed

• Updated server initialization to support both stdio and HTTP transports
• Enhanced error handling for Firebase initialization in all client methods
• Updated module and moduleResolution options in tsconfig.json
• Improved TypeScript type safety across the codebase
• Enhanced ESLint configuration for better TypeScript support
• Upgraded @modelcontextprotocol/sdk from 1.8.0 to 1.11.0 for streamable HTTP support

Fixed

• Improved error handling throughout the application
• Fixed type issues in Firestore query operations

Full Changelog: v1.3.5...v1.4.9

v1.3.5

Added

• Added Codecov integration for enhanced test coverage reporting and visualization

Fixed

• Fixed TypeScript errors in firestoreClient.test.ts by using proper type assertions for filter operators and orderBy parameters

Changed

• Updated dependencies to latest versions:
  • axios: ^1.8.4 → ^1.9.0
  • firebase-admin: ^13.2.0 → ^13.3.0
  • @types/node: ^22.14.0 → ^22.15.14
  • @typescript-eslint/eslint-plugin: ^8.29.1 → ^8.32.0
  • @typescript-eslint/parser: ^8.29.1 → ^8.32.0
  • @vitest/coverage-v8: ^3.1.1 → ^3.1.3
  • eslint: ^9.24.0 → ^9.26.0
  • eslint-config-prettier: ^9.1.0 → ^10.1.2
  • eslint-plugin-prettier: ^5.2.6 → ^5.4.0
  • typescript-eslint: ^8.30.2-alpha.5 → ^8.32.0
  • vitest: ^3.1.1 → ^3.1.3

v1.3.4

[1.3.4] - 2025-04-15

Fixed #49

• Fixed Firestore timestamp handling issues:
  • Fixed inconsistency where timestamp objects were displayed as "[Object]" in responses
  • Added proper conversion of Firestore Timestamp objects to ISO strings
  • Enhanced timestamp filtering to work correctly with both server timestamps and ISO string dates
  • Implemented automatic conversion of ISO string dates to Firestore Timestamp objects when creating/updating documents
  • Improved query filtering to properly handle timestamp comparisons

v1.3.3

[1.3.3] - 2025-04-11

Added

• File upload support for firebase storage #37 by @gannonh in #45
  • storage_upload: Upload files directly to Firebase Storage from text or base64 content
  • storage_upload_from_url: Upload files to Firebase Storage from external URLs
• Permanent public URLs for uploaded files that don't expire and work with public storage rules
• Support for direct local file path uploads - no need for Base64 conversion
• Improved guidance for all MCP clients on file upload best practices
• Automatic filename sanitization for better URL compatibility
• Response formatting metadata for MCP clients to display user-friendly file upload information
• Improved error handling for storage operations
• Automatic content type detection for uploaded files

Fixed

• Fixed response format issues with storage tools to comply with MCP protocol standards
• Fixed image encoding issues to ensure uploaded images display correctly
• Improved error handling for invalid base64 data
• Enhanced MIME type detection for files uploaded from URLs

Full Changelog: v1.3.2...v1.3.3

v1.3.2

[1.3.2] - 2024-04-10

Added

• Added ESLint and Prettier for code quality and formatting
• Added lint and format scripts to package.json
• Added preflight script that runs formatting, linting, tests, and build in sequence
• Enhanced CI workflow to check code formatting and linting
• Added GitHub issues for new feature enhancements

Fixed

• Fixed TypeScript errors in test files
• Fixed tests to work properly in emulator mode
• Excluded test files from production build
• Resolved lint warnings throughout the codebase

Changed

• Updated CI workflow to use preflight script before publishing
• Modified test assertions to be more resilient in different environments
• Improved error handling in storage client tests

Full Changelog: v1.3.0...v1.3.2

v1.3.0

[1.3.0] - 2024-04-05

Added

• Added new firestore_query_collection_group tool to query documents across subcollections with the same name (commit 92b0548)
• Implemented automatic extraction of Firebase console URLs for creating composite indexes when required (commit cf9893b)

Fixed

• Enhanced error handling for Firestore queries that require composite indexes (commit cf9893b)
• Improved test validations to be more resilient to pre-existing test data (commit cf9893b)

Changed

• Updated README to specify 80%+ test coverage requirement for CI (commit 69a3e18)
• Updated .gitignore to exclude workspace configuration files (commit ca42d0f)

Full Changelog: v1.2.0...v1.3.0

v1.2.0

Firebase MCP Server v1.2.0

Overview

Firebase MCP Server enables LLM client applications to interact with Firebase services through the Model Context Protocol (MCP). This server allows AI assistants to securely access Authentication, Firestore, and Storage services.

Features

• Firebase Authentication: User management and verification
• Firestore Integration: Complete document database operations
• Storage Access: File storage and retrieval capabilities
• MCP Compatibility: Works with Claude Desktop, Cursor, Roo Code, Cline, and other MCP clients

Installation

The server can be installed via npx (recommended):

{
  "firebase-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "@gannonh/firebase-mcp"
    ],
    "env": {
      "SERVICE_ACCOUNT_KEY_PATH": "/path/to/serviceAccountKey.json",
      "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app"
    }
  }
}

Getting Started

1. Configure Firebase service account
2. Set environment variables
3. Add server configuration to your MCP settings file
4. Test with: "Please run through and test all of your Firebase MCP tools."

Documentation

Full documentation available at: https://github.com/gannonh/firebase-mcp

License

MIT License