MCP Firebase Server

MCP Firebase Server (Model Context Protocol)

This server implements the Model Context Protocol (MCP) to act as a bridge between a Large Language Model (LLM) like Claude and Firebase (Firestore). It allows the LLM to read from and write to Firestore collections by exposing these operations as MCP "tools."

This server is built using the officialmcpPython SDK.

- Python 3.7+ (preferably 3.8+ forasynccontextmanagerand full type hinting features used by MCP)
- Pip (Python package installer) oruv(recommended by MCP docs for project management)
- A Firebase project with Firestore enabled.
- A Firebase service account key JSON file.
-

Clone/Download:Ensure you have the server file (mcp_firebase_server.py),requirements.txt, etc., in a local directory.

- The server needs a Firebase service account key to authenticate.
- Option 1 (Recommended for MCP Client Configuration):Set theSERVICE_ACCOUNT_KEY_PATHenvironment variable to the absolute path of your service account JSON file. This is the most flexible method when the server is launched by an MCP client.
- Option 2 (Fallback):If theSERVICE_ACCOUNT_KEY_PATHenvironment variable is not set, the server will look for a file namedserviceAccountKey.jsonin its own directory (the same directory asmcp_firebase_server.py). If using this method, rename your key file accordingly.
- Important:Ensure your service account key file (however it's named or accessed) is kept secure and ideally listed in your.gitignoreif a local copy exists in the project.

- If you intend to use Firebase Storage functionalities with this server (currently no tools use it, but it can be added), set theFIREBASE_STORAGE_BUCKETenvironment variable to your Firebase project's storage bucket name (e.g.,your-project-id.appspot.com). The server will read and print this value if set.

Create a Virtual Environment (Recommended):Usingvenv:

python3 -m venv venv source venv/bin/activate # On macOS/Linux # venv\\Scripts\\activate # On Windows

Or, if usinguv(as suggested by MCP docs for new projects):

uv venv source .venv/bin/activate # Or similar, depending on your uv setup

This will installmcp[cli]andfirebase-admin.

There are a couple of ways to run this MCP server:
-

Direct Execution (for stdio transport viarun_server.sh):Arun_server.shscript is provided to simplify launching the server. This script handles activating the virtual environment (if namedvenvand present in the project root) before running the Python script.

This is how an MCP client would typically be configured to launch the server (see "Using with Claude" section below).

Using MCP CLI for Development and Inspection (mcp dev): ThemcpCLI (installed as part ofmcp[cli]) provides a development server and inspector tool. This is highly recommended during development.

- Description (from docstring):Retrieves documents from a specified Firestore collection.
- Arguments:

- Description (from docstring):Adds a new document with an auto-generated ID to the specified Firestore collection.
- Arguments:

- Description (from docstring):Lists all top-level collections in the Firestore database.
- Arguments:

- Description (from docstring):Retrieves a specific document from a Firestore collection by its ID.
- Arguments:

- Description (from docstring):Lists all subcollections of a specified document in Firestore.
- Arguments:

- Description (from docstring):Updates an existing document in a specified Firestore collection.
- Arguments:

- Description (from docstring):Retrieves documents from a specified Firestore collection, filtering by field values (equality==only).
- Arguments:**

- collection_name(string, required): The name of the Firestore collection to query.
- filters(object/dictionary, required): A dictionary where keys are field names and values are the values to filter by (e.g.,{"category": "electronics", "available": True}).
- limit(integer, optional, default: 50): The maximum number of documents to return.