FDIC BankFind MCP-Server

fdic-mcp-server ist ein MCP-Server (Model Context Protocol) für die FDIC BankFind Suite API. Er bietet LLM-Hosts eine saubere Möglichkeit, FDIC-versicherte Institute zu durchsuchen, öffentliche Bankunterlagen abzurufen und gängige Workflows zur Analyse mehrerer Banken ohne benutzerdefinierte FDIC-API-Implementierungen auszuführen.

Er ist nützlich, wenn Sie einen MCP-kompatiblen Client verwenden möchten, um Fragen zu Banken, Insolvenzen, Filialen, vierteljährlichen Finanzdaten, Einlagendaten oder Peer-Performance mithilfe einer stabilen Tool-Oberfläche und maschinenlesbaren Antworten zu beantworten.

Inhaltsverzeichnis

• Projektstatus

• Warum dieses Projekt existiert

• Dokumentation

• Installation

• Verwendung

• Verfügbare Tools

• Datenhinweise

• Support

• Mitwirken

• Lizenz

Related MCP server: census-geocoding-mcp

Projektstatus

Aktive Entwicklung. Der Server ist bereits einsatzbereit und die Tool-Oberfläche ist durch Tests abgedeckt, aber das Projekt entwickelt sich weiter, während die Client-Unterstützung und Analyse-Workflows verbessert werden.

Warum dieses Projekt existiert

Die FDIC BankFind Suite API ist öffentlich und nützlich, aber sie ist nicht von Haus aus für MCP-Clients verpackt. Dieses Projekt löst dies durch:

• Bereitstellung von BankFind-Datensätzen als MCP-Tools

• Beibehaltung sowohl menschenlesbarer als auch maschinenlesbarer Antworten

• Hinzufügen von serverseitigen Analyse-Helfern für Workflows zum Vergleich mehrerer Banken

• Unterstützung sowohl für lokale stdio-Hosts als auch für Remote-HTTP-Hosts

Dokumentation

Öffentliche Benutzerdokumentation:

• Benutzerhandbuch

Referenzdokumentation des Repositorys:

• Referenz-Startseite

• Technische Spezifikation

• Architektur

• Wichtige Entscheidungen

• Cloud Run-Bereitstellung

• Pläne und Design-Notizen

Projekt- und Release-Informationen:

• Release-Historie

• Archivierte Release-Hinweise

• Sicherheitsrichtlinie

Installation

Voraussetzungen:

• Node.js 20 oder höher

• npm

Direkt ohne globale Installation ausführen:

npx fdic-mcp-server

Global installieren:

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

Von GitHub Packages installieren:

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

Aus dem Quellcode installieren:

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

Verwendung

Gehosteter Endpunkt

Wenn Ihr MCP-Host Remote-MCP-URLs unterstützt, verwenden Sie:

https://bankfind.jflamb.com/mcp

Lokal ausführen

Stdio-Transport:

node dist/index.js

HTTP-Transport:

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

Der HTTP-MCP-Endpunkt ist standardmäßig http://127.0.0.1:3000/mcp.

Hinweise:

• Lokale HTTP-Instanzen binden standardmäßig an 127.0.0.1. Setzen Sie HOST, wenn Sie absichtlich eine andere Bindungsadresse wünschen.

• Anfragen mit Browser-Ursprung werden gegen ALLOWED_ORIGINS geprüft. Wenn nicht festgelegt, erlaubt der Server die lokalen Standardwerte für localhost und 127.0.0.1 auf dem konfigurierten Port sowie Nicht-Browser-Anfragen ohne Origin-Header.

• Der HTTP-Transport ist sitzungsbasiert. Clients initialisieren einmal und verwenden dann MCP-Session-Id bei späteren POST-, GET- und DELETE-Anfragen.

Container-Builds verwenden standardmäßig PORT=8080 für die Cloud Run-Kompatibilität.

Setzen Sie FDIC_MAX_RESPONSE_BYTES, um die upstream FDIC-Beschränkung der Antwortgröße zu überschreiben. Der Standardwert ist 5242880 Bytes (5 MiB).

Minimale MCP-Konfiguration

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

Wenn Sie von einem lokalen Klon anstelle des veröffentlichten Pakets ausführen:

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

Client-spezifische Einrichtungsdetails finden Sie unter docs/clients.md.

Anwendungsbeispiele

Aktive Banken in North Carolina mit einem Vermögen von über 1 Milliarde Dollar finden:

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

Die 10 kostspieligsten Bankinsolvenzen seit dem 1. Januar 2000 abrufen:

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

Banken in North Carolina zwischen zwei Quartalsberichtsdaten vergleichen:

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

Eine Peer-Gruppe für eine bestimmte Bank erstellen:

cert: 29846
repdte: 20241231
(fdic_peer_group_analysis)

Weitere Beispiele finden Sie unter docs/usage-examples.md.

Verfügbare Tools

Serverseitige Analyse-Helfer:

• fdic_compare_bank_snapshots bündelt Roster-Suche, Finanz-Snapshots und optionale demografische Snapshots innerhalb des MCP-Servers

• fdic_peer_group_analysis erstellt eine Peer-Gruppe anhand von Kriterien wie Vermögensgröße, Charter-Klasse und Geografie und stuft ein Institut dann im Vergleich zu den Peers ein

• fdic_analyze_bank_health gibt eine vollständige public_camels_proxy_v1-Proxy-Bewertung zurück; fdic_compare_peer_health gibt Zusammenfassungsbewertungen pro Institut mit einem vollständigen Proxy für das Subjekt zurück; fdic_detect_risk_signals verwendet die Proxy-Engine, um Risikosignale pro Institut zu generieren — alles sind analytische Proxys, keine offiziellen regulatorischen CAMELS-Ratings

Claude Code Skills

Dieses Repository enthält einen Claude Code Slash-Befehl, der mehrere FDIC-MCP-Tools zu einem strukturierten Analyse-Workflow verkettet.

Skills sind in .claude/commands/ definiert und stehen jeder Claude Code-Sitzung zur Verfügung, für die dieser MCP-Server konfiguriert ist. Siehe docs/usage-examples.md für ein Anwendungsbeispiel.

Datenhinweise

• Geldwerte werden im Allgemeinen in Tausend Dollar angegeben.

• CERT ist die stabile FDIC-Instituts-ID.

• Finanz- und demografische Datensätze sind vierteljährlich und verwenden REPDTE im Format YYYYMMDD.

• Zusammenfassende Daten sind jährlich und verwenden YEAR.

• SOD-Daten sind jährliche Daten auf Filialebene mit Stand vom 30. Juni.

• Mischen Sie keine vierteljährlichen Finanzdaten und jährlichen Filialdaten, ohne die Datengrundlage anzugeben.

Support

Verwenden Sie den GitHub Issue Tracker für Fehler, Dokumentationsprobleme und Funktionsanfragen: https://github.com/jflamb/fdic-mcp-server/issues

Die wichtigsten Support-Dokumente sind:

• docs/support.md

• docs/prompting-guide.md

• docs/usage-examples.md

• docs/troubleshooting.md

• SECURITY.md

Mitwirken

Anleitungen für Mitwirkende finden Sie unter CONTRIBUTING.md.

Für die lokale Validierung führen Sie aus:

npm run typecheck
npm test
npm run build

Releases werden automatisch aus validierten main-Commits durch semantic-release veröffentlicht. Bearbeiten Sie die Paketversion nicht manuell und erstellen Sie keine Release-Tags von Hand. GitHub Releases ist der maßgebliche Release-Datensatz für veröffentlichte Versionen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.