MCP Firebird

MCP Firebird

site icon
2025.04.13 6
TypeScript数据库管理SQL 查询优化数据安全数据库
MCP Firebird 是一个实现了 Anthropic 的 Model Context Protocol (MCP) 的服务器,专门用于 Firebird SQL 数据库。它允许大型语言模型(如 Claude)安全、可控地访问、分析和操作 Firebird 数据库中的数据。该服务器提供了多种工具和功能,包括数据库查询、性能分析、索引推荐、数据库备份和恢复等,适用于数据分析和 AI 辅助开发等多种场景。
View on GitHub

Overview

基本能力

产品定位

MCP Firebird 是一个专为 Firebird SQL 数据库设计的 MCP 协议实现,旨在为大型语言模型提供安全、可控的数据库访问能力。

核心功能

  • 数据库访问:查询、分析和操作 Firebird 数据库中的数据
  • 性能分析:分析 SQL 查询的执行时间和性能指标
  • 执行计划分析:获取和分析 SQL 执行计划
  • 索引推荐:识别可能提高性能的缺失索引
  • 数据库管理:备份、恢复和验证数据库
  • 安全控制:数据掩码、审计日志和资源限制

适用场景

  1. 数据分析和 AI 辅助:分析历史销售趋势、识别金融数据模式等
  2. SQL 查询生成和优化:从自然语言描述生成 SQL 查询或优化现有查询
  3. 自动化文档:生成数据库结构文档和数据字典
  4. 开发辅助:建议索引、模式规范化和数据迁移

工具列表

  1. list-tables:列出数据库中的所有表
  2. describe-table:描述表的结构
  3. execute-query:执行 SQL 查询
  4. get-field-descriptions:获取字段描述
  5. analyze-query-performance:分析 SQL 查询性能
  6. get-execution-plan:获取 SQL 执行计划
  7. analyze-missing-indexes:分析缺失索引
  8. backup-database:备份数据库
  9. restore-database:恢复数据库
  10. validate-database:验证数据库完整性

常见问题解答

  1. 数据库连接错误:检查凭据和数据库路径,确保 Firebird 服务器正在运行
  2. 服务器未出现在 Claude Desktop 中:重启 Claude Desktop,验证配置
  3. STDIO 问题:确保标准输出未被重定向,使用 console.error 进行调试

使用教程

使用依赖

安装 Node.js 和 npm

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @PuroDelphi/mcpFirebird --client claude

手动安装

# 全局安装
npm install -g mcp-firebird

# 项目安装
npm install mcp-firebird

调试方式

启用调试模式:

export LOG_LEVEL=debug

运行服务器:

npx mcp-firebird --host localhost --port 3050 --database /path/to/database.fdb --user SYSDBA --password masterkey

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。