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 文件。