🚀 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:/// /schema)
- 每个表的 JSON 架构信息
- 包括列名和数据类型
- 自动从数据库元数据中发现
🔧 技术细节
故障排除
常见问题：
- 容器启动失败：
- 确保
DATABASE环境变量正确设置 - 检查 firebird_data 卷上的权限
- 允许足够的时间让 Firebird 服务器初始化
- 数据库初始化：
- 服务器使用多个初始化脚本（init.sql，test_db.sql）
- 确保这些文件具有正确的权限
📄 许可证
此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目存储库中的 LICENSE 文件。