Firebird Mcp Server

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:////schema)
    • 每个表的 JSON 架构信息
    • 包括列名和数据类型
    • 自动从数据库元数据中发现

    🔧 技术细节

    故障排除

    常见问题:

    1. 容器启动失败:
    • 确保 DATABASE 环境变量正确设置
    • 检查 firebird_data 卷上的权限
    • 允许足够的时间让 Firebird 服务器初始化
    1. 数据库初始化:
    • 服务器使用多个初始化脚本(init.sql,test_db.sql)
    • 确保这些文件具有正确的权限

    📄 许可证

    此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由地使用、修改和分发软件,但需遵守 MIT 许可证的条款和条件。有关详细信息,请参阅项目存储库中的 LICENSE 文件。

    • 0 关注
    • 0 收藏,11 浏览
    • system 提出于 2025-09-24 16:21

    相似服务问题