Firebird MCP Server

🚀 Firebird MCP 服務器

Firebird MCP 服務器是一個提供只讀訪問 Firebird 數據庫的模型上下文協議 (Model Context Protocol) 服務器。它讓大型語言模型 (LLMs) 能夠檢查數據庫架構並執行只讀查詢，為數據交互提供了便利。

✨ 主要特性

• 提供對 Firebird 數據庫的只讀訪問。
• 支持大型語言模型檢查數據庫架構和執行只讀查詢。
• 提供每個表的架構信息。

📦 安裝指南

Docker 環境變量

Firebird 容器所需的必需環境變量：

• DATABASE：數據庫文件路徑（例如 /firebird/data/test_db.fdb）
• FIREBIRD_USER：數據庫用戶（默認：SYSDBA）
• FIREBIRD_PASSWORD：數據庫密碼（默認：masterkey）
• EnableLegacyClientAuth：啟用舊版客戶端身份驗證（默認："true"）
• EnableWireCrypt：啟用線纜加密（默認："false"）
• CreateDb：允許創建數據庫（默認："true"）

構建

Docker：

docker build -t mcp/firebird -f src/firebird/Dockerfile .

💻 使用示例

與 Claude Desktop 的使用

要在 Claude Desktop 應用中使用此服務器，將以下配置添加到 claude_desktop_config.json 文件中的 "mcpServers" 部分：

Docker

• 當在 Mac 上運行 Docker 時，請使用 host.docker.internal 如果服務器在主機網絡上運行（例如 localhost）
• 用戶名/密碼可以附加到 Firebird URL 中，如 firebird://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"
      ]
    }
  }
}

將 /test_db 替換為您的數據庫名稱。

📚 詳細文檔

組件

工具

• query
  • 執行針對連接到的數據庫的只讀 SQL 查詢
  • 輸入：sql（字符串）：要執行的 SQL 查詢
  • 所有查詢均在 READ ONLY 事務中執行

資源

該服務器提供每個表的架構信息：

• 表架構 (firebird://<host>/<table>/schema)
  • 每個表的 JSON 架構信息
  • 包括列名和數據類型
  • 自動從數據庫元數據中發現

🔧 技術細節

故障排除

常見問題：

1. 容器啟動失敗：

• 確保 DATABASE 環境變量正確設置
• 檢查 firebird_data 捲上的權限
• 允許足夠的時間讓 Firebird 服務器初始化

2. 數據庫初始化：

• 服務器使用多個初始化腳本（init.sql，test_db.sql）
• 確保這些文件具有正確的權限

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。