Firebird MCP Server

Firebird MCP 服务

一个提供对 Firebird 数据库只读访问的模型上下文协议服务。此服务可让大模型检查数据库架构并执行只读查询。

组件

工具

• query
  • 对已连接的数据库执行只读 SQL 查询
  • 输入：sql（字符串）：要执行的 SQL 查询
  • 所有查询都在 READ ONLY 事务中执行

资源

此服务为数据库中的每个表提供架构信息：

• 表架构（firebird://<host>/<table>/schema）
  • 每个表的 JSON 架构信息
  • 包含列名和数据类型
  • 从数据库元数据中自动发现

在 Claude Desktop 中使用

要将此服务与 Claude Desktop 应用配合使用，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

Docker

• 在 macos 上运行 docker 时，如果服务在主机网络上运行（例如 localhost），请使用 host.docker.internal
• 可在 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 替换为你的数据库名称。

开发环境设置

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 .

故障排除

常见问题：

1. 容器启动失败：

   • 确保已正确设置 DATABASE 环境变量
   • 检查 firebird_data 卷的权限
   • 留出充足时间，以便 Firebird 服务完成初始化

2. 数据库初始化：

   • 此服务使用多个初始化脚本（init.sql、test_db.sql）
   • 确保这些文件具有正确的权限

许可证

此 MCP 服务基于 MIT 许可证授权。这意味着你可以自由使用、修改和分发此软件，但须遵守 MIT 许可证的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。