# Firebase Live MCP Server

MCP server for querying live Firebase projects - Firestore and Cloud Function logs.

## Setup

```bash
npm install
npm run build
```

## Authentication

Uses Application Default Credentials. Run:

```bash
gcloud auth application-default login
```

## Project Detection

The server auto-detects the Firebase project from `.firebaserc` in the current working directory.

Override with env var:

```bash
FIREBASE_PROJECT_ID=my-project
```

## Usage with Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "firebase-live": {
      "command": "node",
      "args": ["/Users/nigelthorne/code/firebase_live_mcp_server/dist/index.js"],
      "cwd": "/path/to/your/firebase/project",
      "env": {
        "FIREBASE_PROJECT_ID": "optional-override"
      }
    }
  }
}
```

The `cwd` should point to a directory with `.firebaserc` for auto-detection.

## Tools

| Tool | Description |
|------|-------------|
| `list_collections` | List top-level Firestore collections |
| `list_subcollections` | List subcollections of a document |
| `list_documents` | List documents in a collection |
| `get_document` | Get a single document by path |
| `query_collection` | Query with filters, ordering, limit |
| `get_function_logs` | Get Cloud Function logs with grep filtering |

### get_function_logs options

- `pattern` - Regex to filter log messages
- `severity` - Minimum level: DEBUG/INFO/NOTICE/WARNING/ERROR/CRITICAL
- `functionName` - Filter by function name
- `limit` - Max entries (default 50)
- `hoursAgo` - Fetch logs from last N hours (default 1)

## Required Permissions

Your gcloud account needs:

- `roles/datastore.viewer` - Firestore read access
- `roles/logging.viewer` - Cloud Logging read access