Firebird MCP 服务器

一个模型上下文协议服务器，提供对 Firebird 数据库的只读访问。该服务器使 LLM 能够检查数据库模式并执行只读查询。

组件

工具

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