Firebird MCP Server
About
A Model Context Protocol (MCP) server for Firebird databases. Enables read-only SQL queries and schema exploration.
Details
- Author
- stagsz
- Downloads
- 383
- Categories
- Other
Jump to
- Execute read-only SQL queries via the query tool.
- Access table schema information as JSON resources.
- Automatically discover schema from database metadata.
- Connect to any Firebird database using a connection URL.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Firebird MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure it in Claude Desktop’s claude_desktop_config.json using either Docker (mcp/firebird image) or NPX (@modelcontextprotocol/server-firebird), supplying a Firebird connection URL like firebird://host:port/database.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"firebird mcp server": {
"firebird-mcp-server": {
"command": "docker",
"args": [
"build",
"-t",
"mcp/firebird",
"-f",
"src/firebird/Dockerfile",
"."
]
}
}
}
}McpServers
{
"firebird-mcp-server": {
"command": "docker",
"args": [
"build",
"-t",
"mcp/firebird",
"-f",
"src/firebird/Dockerfile",
"."
]
}
}Firebird MCP Server
A Model Context Protocol server that provides read-only access to Firebird databases. This server enables LLMs to inspect database schemas and execute read-only queries.
Components
Tools
query Execute read-only SQL queries against the connected database Input:sql (string): The SQL query to execute
All queries are executed within a READ ONLY transaction
Resources
The server provides schema information for each table in the database: Table Schemas (firebird://<host>/<table>/schema)
JSON schema information for each table
Includes column names and data types
Automatically discovered from database metadata
Usage with Claude Desktop
To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:
Docker
When running docker on macos, use host.docker.internal if the server is running on the host network (eg localhost) username/password can be added to the firebird url withfirebird://SYSDBA:masterkey@host:3051/test_db
{
"mcpServers": {
"firebird": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp/firebird",
"firebird://host.docker.internal:3051/test_db"
]
}
}
}
NPX
{
"mcpServers": {
"firebird": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-firebird",
"firebird://localhost:3051/test_db"
]
}
}
}
Replace /test_db with your database name.
Development Setup
Docker Environment Variables
Required environment variables for the Firebird container:
- DATABASE: Path to the database file (e.g., /firebird/data/test_db.fdb)
- FIREBIRD_USER: Database user (default: SYSDBA)
- FIREBIRD_PASSWORD: Database password (default: masterkey)
- EnableLegacyClientAuth: Enable legacy client authentication (default: "true")
- EnableWireCrypt: Enable wire encryption (default: "false")
- CreateDb: Allow database creation (default: "true")
Building
Docker:
docker build -t mcp/firebird -f src/firebird/Dockerfile .
Troubleshooting
Common issues:
1. Container startup failures:
- Ensure the DATABASE environment variable is properly set
- Check permissions on the firebird_data volume
- Allow sufficient time for the Firebird server to initialize
2. Database initialization:
- The server uses several initialization scripts (init.sql, test_db.sql)
- Ensure these files have correct permissions
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
