FDIC BankFind MCPサーバー

fdic-mcp-serverは、FDIC BankFind Suite APIのためのMCP（Model Context Protocol）サーバーです。LLMホストに対し、FDIC保険対象の金融機関の検索、公開銀行記録の取得、および複雑なFDIC APIの構築なしで一般的な複数銀行分析ワークフローを実行するためのクリーンな手段を提供します。

MCP互換クライアントを使用して、銀行、破綻、支店、四半期財務、預金データ、またはピアパフォーマンスに関する質問に、安定したツールインターフェースと機械可読なレスポンスを用いて回答させたい場合に役立ちます。

目次

• プロジェクトステータス

• このプロジェクトの存在理由

• ドキュメント

• インストール

• 使用方法

• 利用可能なツール

• データに関する注意点

• サポート

• 貢献

• ライセンス

Related MCP server: census-geocoding-mcp

プロジェクトステータス

現在活発に開発中です。サーバーは現時点で使用可能であり、ツールインターフェースはテストでカバーされていますが、クライアントサポートや分析ワークフローの改善に伴い、プロジェクトは進化し続けています。

このプロジェクトの存在理由

FDIC BankFind Suite APIは公開されており有用ですが、MCPクライアント向けにパッケージ化されていません。このプロジェクトは以下の方法でそれを解決します：

• BankFindデータセットをMCPツールとして公開する

• 人間が読めるレスポンスと機械が読めるレスポンスの両方を保持する

• 複数銀行比較ワークフローのためのサーバーサイド分析ヘルパーを追加する

• ローカルのstdioホストとリモートのHTTPホストの両方をサポートする

ドキュメント

公開ユーザー向けドキュメント：

• ユーザーガイド

リポジトリ参照ドキュメント：

• リファレンスホーム

• 技術仕様

• アーキテクチャ

• 重要な決定事項

• Cloud Runへのデプロイ

• 計画と設計メモ

プロジェクトおよびリリース情報：

• リリース履歴

• アーカイブされたリリースノート

• セキュリティポリシー

インストール

前提条件：

• Node.js 20以降

• npm

グローバルインストールせずに直接実行：

npx fdic-mcp-server

グローバルインストール：

npm install -g fdic-mcp-server
fdic-mcp-server

GitHub Packagesからインストール：

npm install -g @jflamb/fdic-mcp-server --registry=https://npm.pkg.github.com
fdic-mcp-server

ソースからインストール：

git clone https://github.com/jflamb/fdic-mcp-server.git
cd fdic-mcp-server
npm install
npm run build

使用方法

ホストされたエンドポイント

MCPホストがリモートMCP URLをサポートしている場合、以下を使用します：

https://bankfind.jflamb.com/mcp

ローカルでの実行

Stdioトランスポート：

node dist/index.js

HTTPトランスポート：

TRANSPORT=http PORT=3000 node dist/index.js

HTTP MCPエンドポイントはデフォルトで http://127.0.0.1:3000/mcp です。

注意点：

• ローカルHTTP実行はデフォルトで 127.0.0.1 にバインドされます。意図的に異なるバインドアドレスが必要な場合は HOST を設定してください。

• ブラウザオリジンのリクエストは ALLOWED_ORIGINS に対してチェックされます。設定されていない場合、サーバーは設定されたポート上の localhost および 127.0.0.1 に対するローカルのデフォルト値、および Origin ヘッダーのない非ブラウザリクエストを許可します。

• HTTPトランスポートはセッションベースです。クライアントは一度初期化し、その後のPOST、GET、DELETEリクエストで MCP-Session-Id を再利用します。

コンテナビルドはCloud Runとの互換性のため、デフォルトで PORT=8080 を使用します。

アップストリームのFDICレスポンスサイズ制限を上書きするには FDIC_MAX_RESPONSE_BYTES を設定してください。デフォルトは 5242880 バイト（5 MiB）です。

最小限のMCP設定

{
  "mcpServers": {
    "fdic": {
      "command": "npx",
      "args": ["-y", "fdic-mcp-server"]
    }
  }
}

公開パッケージではなくローカルクローンから実行している場合：

{
  "mcpServers": {
    "fdic": {
      "command": "node",
      "args": ["/path/to/fdic-mcp-server/dist/index.js"]
    }
  }
}

クライアント固有の設定詳細は docs/clients.md を参照してください。

使用例

資産が10億ドルを超えるノースカロライナ州の現役銀行を検索：

filters: STNAME:"North Carolina" AND ACTIVE:1 AND ASSET:[1000000 TO *]

2000年1月1日以降の最もコストのかかった銀行破綻トップ10を取得：

filters: FAILDATE:[2000-01-01 TO *]
sort_by: COST
sort_order: DESC
limit: 10

2つの四半期報告日間のノースカロライナ州の銀行を比較：

state: North Carolina
start_repdte: 20211231
end_repdte: 20250630
sort_by: asset_growth
sort_order: DESC
(fdic_compare_bank_snapshots)

特定の銀行のピアグループを作成：

cert: 29846
repdte: 20241231
(fdic_peer_group_analysis)

その他の例は docs/usage-examples.md にあります。

利用可能なツール

サーバーサイド分析ヘルパー：

• fdic_compare_bank_snapshots は、MCPサーバー内で名簿検索、財務スナップショット、およびオプションの人口統計スナップショットをバッチ処理します

• fdic_peer_group_analysis は、資産規模、チャータークラス、地理的基準からピアグループを作成し、機関をピアと比較してランク付けします

• fdic_analyze_bank_health は完全な public_camels_proxy_v1 プロキシ評価を返します。fdic_compare_peer_health は対象の完全なプロキシを含む機関ごとの要約スコアを返します。fdic_detect_risk_signals はプロキシエンジンを使用して機関ごとのリスクシグナルを生成します。これらはすべて分析プロキシであり、公式の規制上のCAMELS評価ではありません。

Claude Codeスキル

このリポジトリには、複数のFDIC MCPツールを構造化された分析ワークフローにチェーンする Claude Code スラッシュコマンドが含まれています。

スキルは .claude/commands/ で定義されており、このMCPサーバーが設定されたすべてのClaude Codeセッションで利用可能です。使用例については docs/usage-examples.md を参照してください。

データに関する注意点

• 金額は一般的に千ドル単位で報告されます。

• CERT は安定したFDIC機関識別子です。

• 財務および人口統計データセットは四半期ごとで、REPDTE（YYYYMMDD形式）を使用します。

• 要約データは年次で、YEAR を使用します。

• SODデータは6月30日時点の年次支店レベルデータです。

• 日付の基準を明記せずに、四半期財務データと年次支店データを混在させないでください。

サポート

バグ、ドキュメントの問題、機能リクエストについてはGitHubのIssueトラッカーを使用してください: https://github.com/jflamb/fdic-mcp-server/issues

主なサポートドキュメント：

• docs/support.md

• docs/prompting-guide.md

• docs/usage-examples.md

• docs/troubleshooting.md

• SECURITY.md

貢献

貢献者向けガイダンスは CONTRIBUTING.md にあります。

ローカルでの検証には以下を実行してください：

npm run typecheck
npm test
npm run build

リリースは、semantic-release によって検証済みの main コミットから自動的に公開されます。パッケージバージョンを手動で編集したり、手動でリリースを作成したりしないでください。GitHub Releasesが公開バージョンの公式なリリース記録となります。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。