Installing MCP Firebird

June 25, 2026 ยท View on GitHub

This document provides detailed instructions for installing MCP Firebird and its dependencies.

Installing the Node.js Package

MCP Firebird is available as an npm package that can be installed globally or as a project dependency:

# Global installation (Recommended)
npm install -g mcp-firebird

# Project installation
npm install mcp-firebird

Unified Architecture (MCP 2.7+)

Starting with version 2.7+, MCP Firebird uses a unified server architecture. This means a single entry point (mcp-firebird or dist/cli.js) handles both the legacy STDIO transport and the modern Streamable HTTP (SSE) transport.

For network or remote deployments, you should configure it to use SSE by setting TRANSPORT_TYPE=sse and, if exposing over the network, secure it using Enterprise Managed Authorization (EMA) by passing --api-key your_secret_token.

Firebird Client Tools

For database management functions (backup, restore, validation), you need to install the Firebird client tools:

Windows

  1. Download Firebird from https://firebirdsql.org/en/downloads/
  2. Run the installer and select "Client components" during installation
  3. Add the Firebird bin directory to your PATH environment variable (typically C:\Program Files\Firebird\Firebird_X_X\bin)
  4. Restart your terminal or application

macOS

# Using Homebrew
brew install firebird

Linux (Debian/Ubuntu)

sudo apt-get install firebird3.0-utils

Linux (Fedora/RHEL)

sudo dnf install firebird-utils

Alpine Linux

Alpine Linux doesn't include the Firebird client tools needed for backup/restore operations. It's recommended to use Debian/Ubuntu for these operations.

Verifying the Installation

To verify that MCP Firebird has been installed correctly, run:

npx mcp-firebird --version

You should see the current version of MCP Firebird.

Next Steps

Once installed, you can:

  1. Configure MCP Firebird
  2. Run MCP Firebird with Docker
  3. Explore the available tools