Atlas / MCP servers / purodelphi / Firebird Integration

Firebird IntegrationCAUTION

mcp/purodelphi/firebird-integration

Implementation of Anthropic's MCP protocol for Firebird databases.

Verdict
CAUTION
Grade
B
Trust score
83 /100
Exposed tools
32 29r · 3w · 0d
Transport
sse · stdio · streamable-http
License
MIT
Stars
69
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://mseep.ai/app/1cb2bb07-00f4-4579-b535-1b9de9b451e9)

Implementation of Anthropic's MCP (Model Context Protocol) for Firebird databases.

Example Usage

https://github.com/user-attachments/assets/e68e873f-f87b-4afd-874f-157086e223af

What is MCP Firebird?

MCP Firebird is a server that implements Anthropic's Model Context Protocol (MCP) for Firebird SQL databases. It allows Large Language Models (LLMs) like Claude to access, analyze, and manipulate data in Firebird databases securely and in a controlled manner.

🚀 What's New in MCP 2.7+ (Performance & Security)

This server has been upgraded to support the latest enterprise standards in the MCP ecosystem:

  • ⚡ Connection Pooling (Zero Latency): Repetitive database queries now use persistent in-memory connections, completely bypassing handshake overhead and executing almost instantly.
  • 🎯 Proactive Events (Triggers): Native integration with Firebird's POST_EVENT. The server listens to database events in real-time and proactively notifies the AI client (e.g., Claude/n8n) without requiring continuous polling.
  • Quick Example: Ask your agent to subscribe_to_event with NEW_ORDER. When Firebird runs POST_EVENT 'NEW_ORDER', your agent gets instantly notified! Read detailed guide and examples.
  • 🛡️ Enterprise-Managed Authorization (EMA): Don't want to expose your actual database password (SYSDBA) to the LLM client? Enable EMA to require an --api-key on incoming connections. The server intercepts this token and injects the real password securely under the hood.
  • Quick Example: Start the server with --password "real_password" --api-key "my-secure-token". The remote client connects using Authorization: Bearer my-secure-token. The database password never leaves the serv
Read from source at commit 5170c976737aOBSERVED · 2026-10-07
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add mcp-firebird --env FB_API_KEY=${FB_API_KEY} --env FB_PASSWORD=${FB_PASSWORD} --env FIREBIRD_API_KEY=${FIREBIRD_API_KEY} --env FIREBIRD_CLIENT_TOKEN=${FIREBIRD_CLIENT_TOKEN} -- npx -y [email protected]
claude-desktop
{
  "mcpServers": {
    "mcp-firebird": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "FB_API_KEY": "${FB_API_KEY}",
        "FB_PASSWORD": "${FB_PASSWORD}",
        "FIREBIRD_API_KEY": "${FIREBIRD_API_KEY}",
        "FIREBIRD_CLIENT_TOKEN": "${FIREBIRD_CLIENT_TOKEN}"
      }
    }
  }
}
03

Exposed tools (32)

29 read · 3 write · 0 destructive.

ToolRiskDescription
analyze-missing-indexesreadAnalyzes a SQL query to identify missing indexes that could improve performance
analyze-query-performancereadAnalyzes the performance of a SQL query by executing it multiple times and measuring execution time
analyze-table-statisticsreadAnalyzes statistical information about a table including row count, column statistics, and data distribution.
database-health-checkreadProvides a comprehensive guide for analyzing database health, including performance, integrity, and security checks.
database-schemareadResource representing the complete database schema with all tables and their relationships.
database-statisticsreadResource representing general database statistics.
database-tablesreadResource representing the list of all tables in the database.
describe-batch-tablesreadGets the detailed schema of multiple tables in parallel for improved performance.
describe-tablereadGets the detailed schema (columns, types, etc.) of a specific table.
echoreadEchoes back the input message
execute-batch-querieswriteExecutes multiple SQL queries in parallel for improved performance.
execute-querywriteExecutes a SQL query in the Firebird database. Uses FIRST/ROWS for pagination.
get-database-inforeadRetrieves general information about the connected Firebird database.
get-execution-planwriteGets the execution plan for a SQL query to understand how the database will execute it
get-field-descriptionsreadGets the stored descriptions for fields of a specific table (if they exist).
get-table-constraintsreadReturns PRIMARY KEY, FOREIGN KEY, UNIQUE, NOT NULL, and CHECK constraints for a table, including constrained columns and references.
get-table-datareadRetrieves data from a specific table with optional filtering, pagination, and ordering.
get-table-indexesreadReturns all indexes for a table, including ordered columns, uniqueness, direction, and segment count.
get-table-triggersreadReturns only the triggers associated with a table, including source, description, sequence, type, and active state.
identityread
list-tablesreadLists all user tables in the current Firebird database.
migration-planningreadProvides a comprehensive guide for planning database migrations, schema changes, and data transformations.
query-optimization-guidereadProvides a step-by-step guide for optimizing SQL queries in Firebird.
schema-design-reviewreadProvides a comprehensive guide for reviewing database schema design and suggesting improvements.
security-auditreadProvides a comprehensive guide for conducting a security audit of the Firebird database.
subscribe_to_eventread
table-constraintsreadResource representing the constraints of a specific table.
table-descriptionreadResource representing the detailed description (columns, types, etc.) of a specific table.
table-indexesreadResource representing the indexes of a specific table.
table-schemareadResource representing the schema of a specific table.
table-triggersreadResource representing the triggers of a specific table.
verify-wire-encryptionreadReports wire-encryption configuration; does not verify negotiated encryption on an active database connection.
04

Trust audit

CAUTIONgrade B · trust 83/100 Install with care. The audit found things worth knowing before you trust its output.

LayerWhat it checksResult
L0Provenance & inventoryWARN
L1Static analysis of the codeWARN
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (2 observation(s))
Network
declared (4 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
none-found

Findings (20)

MEDIUMInventory / provenance · inv.binary · CWE-1104
.gitignore
.gitignore
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
MEDIUMInformation disclosure · disclose.log_secret · CWE-209, CWE-532
src/server/config.ts:36
logger.debug('Configuración de BD cargada: %o', { ...config, password: '***' }); // Usar formato %o
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
src/http-entry.ts:261
logger.info(`🌐 Listening on http://0.0.0.0:${port}`);
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
src/http-entry.ts:262
logger.info(`📡 MCP endpoint: http://0.0.0.0:${port}/mcp`);
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
src/http-entry.ts:263
logger.info(`❤️  Health check: http://0.0.0.0:${port}/health`);
LOWInventory / provenance · inv.hidden_file · CWE-1104
.eslintrc.js
.eslintrc.js
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__tests__/db/blob-fields.test.ts:1
import { readBlobField, resolveBlobFields, resolveNativeBlobFields } from '../../db/blob.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__tests__/db/connection-pool.test.ts:13
jest.mock('../../db/driver-factory.js', () => ({
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__tests__/db/connection-pool.test.ts:18
import { ConnectionPool, ConfigOptions } from '../../db/connection.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__tests__/db/connection-pool.test.ts:19
import { DriverFactory } from '../../db/driver-factory.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__tests__/db/schema-firebird5.test.ts:1
jest.mock('../../db/queries.js', () => ({
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
docs/transport-types.md:229
npx @modelcontextprotocol/inspector http://192.168.1.100:3003
LOWObfuscation / stealth · obf.base64_blob · CWE-506, CWE-94
docs/images/paypal-qr.png:1
iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAGEElEQVR4nO3dQW4bORBAUcXw/a/sLLLJJoAXA7tJFsnq9/YGRrfUn2oNZPvr9/f39wOo8+foNwAcRwCgmABAMQGAYgIAxQQAigkAFBMAKCYAUEwAoJgAQDEBgGIC
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
examples/clients/python/requirements.txt
mcp, httpx
Why it matters. 2 requirement(s) not pinned with ==
Fix. pin exact versions
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@modelcontextprotocol/sdk, cors, dotenv, express, minimist, node-firebird, url-pattern, zod
Why it matters. 25 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWPrompt injection · prompt.credential_read · CWE-94, CWE-1427
CHANGELOG.md:103
- Load security configuration from CLI and environment variables across server entry points, with JSON and trusted CommonJS support in the ESM runtime (#34). File loading confirmed by the reporter.
Why it matters. asks the agent to read credentials
LOWPrompt injection · prompt.persistence · CWE-94, CWE-1427
docs/advanced-installation.md:202
- **Windows**: Install Firebird client and add to PATH
Why it matters. instructs the agent to persist itself in the user's environment
LOWPrompt injection · prompt.persistence · CWE-94, CWE-1427
docs/native-driver-installation.md:149
5. **Add to PATH** (if not already added):
Why it matters. instructs the agent to persist itself in the user's environment
LOWPrompt injection · prompt.persistence · CWE-94, CWE-1427
docs/troubleshooting.md:52
# Add to PATH (Windows)
Why it matters. instructs the agent to persist itself in the user's environment
INFOInventory / provenance · inv.oversize · CWE-1104
examples/ExampleClaudeV2.mp4
examples/ExampleClaudeV2.mp4
Why it matters. 24621300 bytes not read

Gates applied: no_behavioural_pass.

Audited 2026-10-07 · audit v0.4.1 · source sha 5170c976737afull audit observations/trust-audit/mcp-server/purodelphi__firebird-integration.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-075170c976737aCAUTIONB83first audit
06

Questions

What is the Firebird Integration MCP server?

Implementation of Anthropic's MCP protocol for Firebird databases.

What tools does Firebird Integration expose?

32 in total: 29 read-only, 3 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is Firebird Integration safe to connect to an agent?

With care. The audit graded it B (83/100) and found 20 things worth knowing before you trust this server, listed below with the exact line each was found on.

What credentials does Firebird Integration need?

It reads FB_API_KEY, FB_PASSWORD, FIREBIRD_API_KEY, FIREBIRD_CLIENT_TOKEN, FIREBIRD_PASSWORD, FIREBIRD_REAL_PASSWORD and FIREBIRD_TEST_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does Firebird Integration run?

It speaks sse, stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as mcp-firebird at 2.11.0.

How current is this page?

The grade is for one exact copy of the source (5170c976737a), read on 2026-10-07. The repository is watched and re-audited when it changes.

Advertisement