firestore-https-flutter

A Dart package implementing a Model Context Protocol (MCP) server for accessing Cloud Firestore. It supports HTTP transport.

Prerequisites

  • Dart SDK >= 3.10.4
  • A Google Cloud Project with Firestore enabled.
  • GOOGLE_CLOUD_PROJECT environment variable set to your Google Cloud project ID.
  • Google Cloud credentials configured (e.g. via gcloud auth application-default login).

Usage

Run the server over HTTP (SSE):

dart run bin/firestore_https_flutter.dart --port 8080 --host localhost --path /mcp

Tools

The server exposes the following MCP tools for managing a "Cymbal Superstore Inventory":

  • greet: Get a greeting (test tool).
    • Arguments: name (string)
  • get_products: Get a list of all products from the inventory collection.
  • get_product_by_id: Get a single product by its ID.
    • Arguments: id (string)
  • search: Search for products in the inventory by name (case-insensitive).
    • Arguments: query (string)
  • seed: Seed the inventory collection with sample data (Apples, Bananas, etc.).
  • reset: Clear all documents from the inventory collection.
  • get_root: Get a welcome message from the API.

Development

Running Tests

dart test

Analysis

dart analyze

Libraries

firestore_https_flutter