Firebird MCP Server

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

组件

工具

• query
  • 对连接的数据库执行只读SQL查询
  • 输入：sql (字符串)：要执行的SQL查询
  • 所有查询都在一个只读事务中执行

资源

该服务器提供了数据库中每个表的模式信息：

• 表模式 (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文件。 </中文翻译>