Firebird MCP Server

🚀 Firebird MCP サーバ

Firebird データベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコル (Model Context Protocol) サーバです。このサーバにより、大規模言語モデル (LLMs) がデータベーススキーマを調べ、読み取り専用クエリを実行できるようになります。

✨ 主な機能

🔧 ツール

• query
  • 接続されたデータベースに対する読み取り専用の SQL クエリを実行します。
  • 入力：sql（文字列）：実行する SQL クエリ
  • すべてのクエリは READ ONLY トランザクション内で実行されます。

📦 リソース

このサーバは、各テーブルのスキーマ情報を提供します。

• テーブルスキーマ (firebird://<host>/<table>/schema)
  • 各テーブルの JSON 形式のスキーマ情報です。
  • 列名とデータ型が含まれています。
  • データベースのメタデータから自動的に検出されます。

💻 使用例

Claude Desktop との連携

Claude Desktop アプリでこのサーバを使用するには、claude_desktop_config.json ファイルの "mcpServers" セクションに以下の設定を追加してください。

Docker

• Mac で 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 ファイルを参照してください。