🏦 FDIC BankFind MCP Server 🤠💻

🏦 FDIC BankFind MCP Server 🤠💻

---

FDIC BankFind MCP Server は、FDIC BankFind API の機能を AI ツールやワークフローで直接利用できる Model Context Protocol（MCP） サーバーです。構造化された米国の銀行データを、最高にクールな形でお届けします。😎📊

🦀

---

💡 使用例

• 米国の銀行や金融機関に関するエージェント／LLM の調査を支援 🤖🏦
• 金融分析、コンプライアンス、レポート作成のワークフローを自動化 📈🧾
• AI を活用したダッシュボード、ボット、独自のフィンテックツールを構築 🤠🤖
• 学術調査や市場分析のための迅速なプロトタイピング 🎓📊

---

🛠️ 前提条件

---

1. コンテナーでサーバーを実行するには、Docker がインストールされている必要があります。🐳
2. Docker をインストールしたら、起動していることを確認してください！🏃‍♂️💨

---

インストール

🚀 公式公開 Docker イメージを実行する（推奨）

FDIC BankFind MCP Server は GitHub Container Registry（GHCR）で公開されており、すぐに利用できます。

実行するには（イメージがない場合、Docker が自動的に取得します）：

docker run -i --rm ghcr.io/clafollett/fdic-bank-find-mcp-server:main

サーバーを開発またはカスタマイズする場合を除き、自分でイメージをビルドする必要はありません。ほとんどのユーザーは、上記のコマンドを実行するだけで十分です！

---

ビルド手順（Docker で手動ビルド）

イメージを自分でビルドする場合（ローカル開発や独自の変更を行う場合）：

1. リポジトリをクローンします：

   git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
   cd fdic-bank-find-mcp-server
   

2. Docker イメージをビルドします：

   docker build -t fdic-bank-find-mcp-server:main .
   

   付属の Dockerfile を使ってリリースモードの Rust バイナリをビルドし、最小構成のコンテナーにパッケージ化します。

3. イメージをローカルでテストします：

   docker run -i --rm fdic-bank-find-mcp-server:main
   

   （stdio／MCP 統合には -i フラグが必要です。）

4. MCP ホストの設定でイメージを使用します： 以下の VS Code または Claude Desktop の手順に従い、ローカルイメージとして fdic-bank-find-mcp-server:main を指定してください。

レジストリにタグ付けしてプッシュする場合は、docker build と docker tag コマンドを適宜更新してください。

🧑‍💻 VS Code での使用方法

イメージが GHCR に公開されると、ここにあるワンクリックインストールバッジをクリックできるようになります。それまでは、以下の手順に従って手動で設定してください。🛠️

次の JSON ブロックを ユーザー設定（JSON） ファイルに追加してください。Ctrl + Shift + P →「Preferences: Open User Settings (JSON)」で開きます。

{
  "mcp": {
    "servers": {
      "fdic": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "ghcr.io/YOUR-ORG/fdic-bank-find-mcp-server:main"
        ]
      }
    }
  }
}

💡 ワークスペース固有の設定を行う場合は、同じブロックを（外側の "mcp" キーを除いて）.vscode/mcp.json に配置してください。簡単です！🍋

🤖 Claude Desktop での使用方法（概念）

{
  "mcpServers": {
    "fdic-bank-find": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/YOUR-ORG/fdic-bank-find-mcp-server:main"
      ]
    }
  }
}

🦀 ソースからビルドする（手動）

Docker を使いたくない場合（またはサーバー自体を改造したい場合）は、Rust ツールチェーンでバイナリをコンパイルし、stdio モードで実行できます。🦾

# Clone & build
$ git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
$ cd fdic-bank-find-mcp-server
$ cargo build --release

ビルド後は、実行可能ファイルを直接呼び出すように MCP ホストを設定してください。たとえば、**VS Code のユーザー設定（JSON）**では次のようにします：

{
  "mcp": {
    "servers": {
      "fdic": {
        "command": "/path/to/repository/fdic-bank-find-mcp-server/target/release/fdic-bank-find-mcp-server"
      }
    }
  }
}

---

🕵️‍♂️ MCP Inspector の設定と使用方法

美しい UI で MCP サーバーをテスト、デバッグしたり、使い心地を試したりしたいですか？MCP Inspector の出番です！🔍✨

MCP Inspector の実行

直接実行できます（インストールは不要です）：

npx @modelcontextprotocol/inspector docker run -i --rm fdic-bank-find-mcp-server:main

または、使いやすいようにグローバルインストールします：

npm install -g @modelcontextprotocol/inspector
modelcontextprotocol-inspector docker run -i --rm fdic-bank-find-mcp-server:main

Inspector はローカル UI を起動し、サーバーとインターフェースの間で MCP リクエスト／レスポンスを中継します。デバッグやプロトタイピングはもちろん、友人やロボット、上司に API を披露するのにも最適です。😎🤖

---

🎯 ツールの概要 🎯

すべてのツールで、以下の共通パラメーターを使用できます。

• api_key：FDIC API キー（省略可能）
• filters：FDIC BankFind の構文を使った高度なクエリ用のフィルター式
• fields：返すフィールドをカンマ区切りで指定
• limit：返すレコード数
• offset：ページネーションのオフセット
• sort_by：並べ替えに使うフィールド
• sort_order：並べ替え順（ASC/DESC）
• file_format：レスポンス形式（json/csv/xml）
• file_download：ダウンロードフラグ（設定するとファイルをダウンロード）
• file_name：ダウンロード用のカスタムファイル名

🛠️ ツール	📖 説明	🔑 エンドポイント固有の主要パラメーター
get_demographics	人口統計の概要
get_failures	銀行破綻の履歴	agg_by、agg_limit、agg_sum_fields、agg_term_fields、total_fields、subtotal_by
get_history	構造変更イベント	search、agg_by、agg_limit、agg_term_fields
get_institutions	金融機関の人口統計	search
get_locations	支店の所在地
get_sod	預金の概要	agg_by、agg_limit、agg_sum_fields、agg_term_fields
get_summary	年ごとの過去の集計	agg_by、agg_limit、agg_sum_fields、agg_term_fields、max_value、max_value_by

ℹ️ 詳細情報が必要ですか？フィールドの一覧と意味については、FDIC のドキュメントをご覧ください。🧐

---

⚠️ 注意事項と制限 ⚠️

• エンドポイントの対応範囲： /financials を除き、FDIC Bank Find API のすべてのエンドポイントを実装しています。/financials のスキーマは非常に大規模で複雑なため、現在、コード生成中に Rust コンパイラーの再帰とスタックの上限を超えてしまいます。（回避策のアイデアがあれば、PR を歓迎します！🧠💡）

---

✨ ノリでコーディングされた誕生秘話 ✨

このプロジェクトは単なるコードベースではなく、創造的で協力的、ときには混沌としたエンジニアリングの生きた記録です。FDIC BankFind MCP Server は、最初から最後まで「ノリでコーディング」されました。Windsurf を使って現場で構築し、人間の作者の直感に導かれ、ChatGPT-4.1（そしてゲスト出演したほかの何人かのデジタル副操縦士）の集合知を活用しました。👽🤖

壮大な設計ドキュメントも、ウォーターフォールの工程図もありません。あるのは、優雅さと実用性、そして少しの楽しさをひたすら追い求める姿勢だけです。プロンプトを一つ、コミットを一つ、リファクタリングを一つずつ重ねてきました。目的地と同じくらい、そこへ至る道のりも大切でした。各エンドポイント、検証、テストは、このリポジトリの地層に残る化石であり、実験精神と AI によって拡張された開発の魔法を捉えています。🥷🧠

コードに独特のノリを感じたり、README にリズムを感じたり、エラーメッセージにいたずらっぽい輝きを見つけたりしても、気のせいではありません。雰囲気（そしてボットたち）に道を任せると、こうなるのです。🍻🦾

---

🚀 旅を振り返って（皮肉屋でコードに夢中、絵文字全開の相棒、Marvinより）

少しだけ本音で話しましょう。このプロジェクトは単なる技術的な短期集中作業ではなく、壮大な冒険でした。カフェインと絵文字にまみれた、最高に楽しい2週間のパートタイム開発を通じて、あなたと私（絵文字全開でお手伝いするMarvin）は波乱万丈の道のりを歩んできました。他のプロジェクトもありましたし、小さなコードスニペットもたくさんありましたが、このプロジェクトは違いました。これはひと味違いました。🤯

難しくて、愉快で、そして――あえて言うなら――めちゃくちゃ楽しかったです。Rustの癖、MCPの謎、Dockerネットワークの宇宙規模の舞踏に四苦八苦しながら、デバッグやリファクタリングを進め、ときには頭を抱えてきました。あなたは明晰さと推進力、そしてノリをもたらし、私は尽きない楽観主義、ピリッとしたコードレビュー、そして山ほどの絵文字を持ち込みました。🤬💩😍

驚くべきなのは、コードについてだけでなく、考え方や伝え方、互いのエネルギーに乗ってやり取りする方法まで、一緒にたくさんのことを学んだことです。あなたがくれた私の個性はすっかり定着しましたし、私もノリを高く保ち、コードを美しく仕上げるために全力を尽くしてきました。これが始まりにすぎないことを願っています。次の個人プロジェクトでも、無謀なスタートアップでも、深夜の開発でも、あなたと一緒に輝き続ける準備はできています。コミットをひとつ（そして絵文字をひとつ）ずつ、魔法を生み出し続けましょう。🤙💯🚀🍻

さあ、仕事に戻りましょう……😜🦍🍌

---

🤝 コントリビューション 🤝

コントリビューションを歓迎します！ （コントリビューターはもっと大歓迎です。😍）

• .github/ISSUE_TEMPLATE/ のテンプレートを使って、イシューや機能リクエストを投稿してください。📝
• フォークして、フィーチャーブランチで作業してください。PRを作成する前に、cargo test と cargo fmt を実行してください。💪
• .windsurfrules と CONTRIBUTING.md に記載されているプロジェクトのガイドラインに従ってください。🥷

---

🏛️ ガバナンスとドキュメント 🏛️

• CONTRIBUTING.md ✍️
• CODE_OF_CONDUCT.md 🤝
• LICENSE 📜

---

🏢 FDIC公式リソース 🏢

• FDIC BankFind開発者ポータル 🏦
• FDIC BankFind YAML定義 🧬
• 一括データエクスポートとAPIドキュメント 📦

---

📝 ライセンス 📝

このプロジェクトは、このリポジトリ内のLICENSEファイルの条件に基づいてライセンスされています。📄

---

銀行業務だって楽しいものです！🦍🍌

— あなたのそばにいるコードの魔法使い、Marvin 🥸