Firebird MCP Server

基本能力

产品定位

Firebird MCP Server 是一个数据库访问服务，专注于提供对Firebird数据库的只读访问和模式检查功能。

核心功能

1. 只读查询：通过SQL查询执行对Firebird数据库的只读操作。
2. 模式检查：自动发现并提供数据库中每个表的JSON模式信息，包括列名和数据类型。

适用场景

1. 数据库模式检查：开发人员或LLMs可以快速了解数据库结构。
2. 只读数据分析：执行数据分析查询而不影响数据库状态。
3. 集成开发：与Claude Desktop等工具集成，提供数据库访问能力。

工具列表

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

常见问题解答

1. 容器启动失败：
2. 确保DATABASE环境变量正确设置
3. 检查firebird_data卷的权限
4. 给Firebird服务器足够的初始化时间
5. 数据库初始化问题：
6. 确保初始化脚本（init.sql, test_db.sql）有正确的权限

使用教程

使用依赖

1. Docker环境（用于容器化部署）
2. Node.js环境（用于NPX安装）

安装教程

Docker安装

docker build -t mcp/firebird -f src/firebird/Dockerfile .

NPX安装

npx -y @modelcontextprotocol/server-firebird firebird://localhost:3051/test_db

调试方式

1. 检查容器日志：

docker logs <container_id>

1. 验证数据库连接：

# 使用Firebird客户端工具连接数据库
isql -user SYSDBA -password masterkey localhost:3051/test_db

许可证

该项目遵循 MIT 开源许可条款。