Servidor MCP FDIC BankFind

fdic-mcp-server es un servidor MCP (Model Context Protocol) para la API de FDIC BankFind Suite. Ofrece a los hosts de LLM una forma limpia de buscar instituciones aseguradas por la FDIC, recuperar registros bancarios públicos y ejecutar flujos de trabajo comunes de análisis multibancario sin la complejidad de la API de la FDIC.

Es útil cuando desea que un cliente compatible con MCP responda preguntas sobre bancos, quiebras, sucursales, estados financieros trimestrales, datos de depósitos o rendimiento entre pares utilizando una superficie de herramientas estable y respuestas legibles por máquina.

Tabla de contenidos

• Estado del proyecto

• Por qué existe este proyecto

• Documentación

• Instalación

• Uso

• Herramientas disponibles

• Notas sobre los datos

• Soporte

• Contribución

• Licencia

Related MCP server: census-geocoding-mcp

Estado del proyecto

Desarrollo activo. El servidor es utilizable hoy en día y la superficie de herramientas está cubierta por pruebas, pero el proyecto sigue evolucionando a medida que mejoran el soporte al cliente y los flujos de trabajo de análisis.

Por qué existe este proyecto

La API de FDIC BankFind Suite es pública y útil, pero no está empaquetada para clientes MCP de forma nativa. Este proyecto resuelve eso mediante:

• la exposición de conjuntos de datos de BankFind como herramientas MCP

• la preservación de respuestas tanto legibles por humanos como por máquinas

• la adición de ayudantes de análisis del lado del servidor para flujos de trabajo de comparación multibancaria

• el soporte tanto para hosts locales stdio como para hosts HTTP remotos

Documentación

Documentación pública para el usuario:

• Guía del usuario

Documentación de referencia del repositorio:

• Inicio de referencia

• Especificación técnica

• Arquitectura

• Decisiones clave

• Despliegue en Cloud Run

• Planes y notas de diseño

Información del proyecto y lanzamientos:

• Historial de lanzamientos

• Notas de lanzamiento archivadas

• Política de seguridad

Instalación

Requisitos previos:

• Node.js 20 o posterior

• npm

Ejecutar directamente sin una instalación global:

npx fdic-mcp-server

Instalar globalmente:

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

Instalar desde GitHub Packages:

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

Instalar desde el código fuente:

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

Uso

Endpoint alojado

Si su host MCP admite URLs MCP remotas, utilice:

https://bankfind.jflamb.com/mcp

Ejecutar localmente

Transporte stdio:

node dist/index.js

Transporte HTTP:

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

El endpoint HTTP MCP es http://127.0.0.1:3000/mcp por defecto.

Notas:

• Las ejecuciones HTTP locales se vinculan a 127.0.0.1 por defecto. Establezca HOST si desea intencionalmente una dirección de vinculación diferente.

• Las solicitudes de origen del navegador se verifican contra ALLOWED_ORIGINS. Si no se establece, el servidor permite los valores predeterminados locales para localhost y 127.0.0.1 en el puerto configurado, además de solicitudes que no provienen del navegador sin encabezado Origin.

• El transporte HTTP está basado en sesiones. Los clientes se inicializan una vez y luego reutilizan MCP-Session-Id en solicitudes POST, GET y DELETE posteriores.

Las compilaciones de contenedores utilizan PORT=8080 por defecto para la compatibilidad con Cloud Run.

Establezca FDIC_MAX_RESPONSE_BYTES para anular el límite de tamaño de respuesta de la FDIC ascendente. El valor predeterminado es 5242880 bytes (5 MiB).

Configuración mínima de MCP

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

Si está ejecutando desde un clon local en lugar del paquete publicado:

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

Los detalles de configuración específicos del cliente se encuentran en docs/clients.md.

Ejemplos de uso

Encontrar bancos activos en Carolina del Norte con activos superiores a $1 mil millones:

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

Obtener las 10 quiebras bancarias más costosas desde el 1 de enero de 2000:

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

Comparar bancos de Carolina del Norte entre dos fechas de informes trimestrales:

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

Construir un grupo de pares para un banco específico:

cert: 29846
repdte: 20241231
(fdic_peer_group_analysis)

Más ejemplos en docs/usage-examples.md.

Herramientas disponibles

Ayudantes de análisis del lado del servidor:

• fdic_compare_bank_snapshots agrupa la búsqueda de listas, instantáneas financieras y, opcionalmente, instantáneas demográficas dentro del servidor MCP

• fdic_peer_group_analysis construye un grupo de pares a partir de criterios de tamaño de activos, clase de estatuto y geografía, y luego clasifica una institución frente a sus pares

• fdic_analyze_bank_health devuelve una evaluación proxy completa public_camels_proxy_v1; fdic_compare_peer_health devuelve puntuaciones resumidas por institución con un proxy completo para el sujeto; fdic_detect_risk_signals utiliza el motor proxy para generar señales de riesgo por institución: todos son proxies analíticos, no calificaciones CAMELS regulatorias oficiales

Habilidades de Claude Code

Este repositorio incluye un comando de barra de Claude Code que encadena múltiples herramientas MCP de la FDIC en un flujo de trabajo de análisis estructurado.

Las habilidades se definen en .claude/commands/ y están disponibles para cualquier sesión de Claude Code con este servidor MCP configurado. Consulte docs/usage-examples.md para ver un ejemplo de uso.

Notas sobre los datos

• Los valores monetarios generalmente se informan en miles de dólares.

• CERT es el identificador estable de la institución de la FDIC.

• Los conjuntos de datos financieros y demográficos son trimestrales y utilizan REPDTE en YYYYMMDD.

• Los datos resumidos son anuales y utilizan YEAR.

• Los datos SOD son datos anuales a nivel de sucursal al 30 de junio.

• No mezcle datos financieros trimestrales y datos anuales de sucursales sin indicar la base de fecha.

Soporte

Utilice el rastreador de problemas de GitHub para errores, problemas de documentación y solicitudes de funciones: https://github.com/jflamb/fdic-mcp-server/issues

La documentación de soporte principal es:

• docs/support.md

• docs/prompting-guide.md

• docs/usage-examples.md

• docs/troubleshooting.md

• SECURITY.md

Contribución

La guía para colaboradores se encuentra en CONTRIBUTING.md.

Para la validación local, ejecute:

npm run typecheck
npm test
npm run build

Los lanzamientos se publican automáticamente desde confirmaciones validadas de main mediante semantic-release. No edite manualmente la versión del paquete ni cree etiquetas de lanzamiento a mano. GitHub Releases es el registro de lanzamiento oficial para las versiones publicadas.

Licencia

Este proyecto está bajo la Licencia MIT.