MCP Server

    Direct database access using Model Context Protocol

    We have a Model Context Protocol (MCP) server that lets you interact with our Firebase database directly from Claude Code or other MCP-compatible tools.

    ⚠️ CRITICAL WARNING

    This MCP server uses PRODUCTION data!

    Be extremely careful when using this server. Any changes you make will affect the live website and real user data.

    You should primarily use this for reading data.

    While write operations (Create, Update, Delete) are available, don't go crazy with them. Only make changes when absolutely necessary and you know what you're doing.

    What is MCP?

    Model Context Protocol (MCP) is a standard protocol that allows AI assistants like Claude to interact with external tools and data sources.

    Our MCP server exposes Firebase operations (CRUD) so you can query and manipulate the database directly through Claude Code.

    📚 Learn more about MCP:

    Model Context Protocol Documentation

    Setup for Claude Code

    To use the MCP server with Claude Code, add this configuration to your Claude Code settings:

    Configuration:

    {
  "mcpServers": {
    "gdg-website": {
      "command": "/path/to/node",
      "args": ["/Users/your-username/Documents/gdg-website/mcp/build/index.js"],
      "env": {
        "NODE_ENV": "development",
        "FIREBASE_PROJECT_ID": "your-project-id",
        "FIREBASE_CLIENT_EMAIL": "firebase-adminsdk-xxxxx@your-project.iam.gserviceaccount.com",
        "FIREBASE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
      }
    }
  }
}

    Important notes:

    • Replace /path/to/node with your Node.js binary path
    • Update the path to mcp/build/index.js to match your local setup
    • Get Firebase credentials from the project owner (Albert)
    • The FIREBASE_PRIVATE_KEY must have \\n escaped as shown

    What You Can Do

    Once configured, you can perform CRUD operations on the Firebase database:

    ✅ Safe Operations (Recommended)

    • Read: Query teams, positions, events, users
    • List: Get all documents from a collection
    • Debug: Inspect data structure and relationships
    • Verify: Check if data exists or validate database state

    ⚠️ Use with Caution

    • Create: Add new documents (make sure they're valid!)
    • Update: Modify existing documents
    • Delete: Remove documents (this is permanent!)

    Best Practices

    • 1. Read First, Write Later

      Always query and inspect data before making any changes.

    • 2. Test Locally First

      If possible, test your operations on local/development data before touching production.

    • 3. Small Changes

      Make small, incremental changes rather than bulk operations.

    • 4. Verify After Writing

      After creating, updating, or deleting, read the data back to confirm the operation succeeded correctly.

    • 5. Ask for Help

      If you're unsure about an operation, ask Albert or another team member first.

    📂 MCP Server Location

    The MCP server code lives at:

    mcp/ directory in the project root

    ← Deployment GuideNext: Contributing →