Servidor MCP de FDIC BankFind | Awesome MCP Servers

🏦 Servidor MCP de FDIC BankFind 🤠💻

El Servidor MCP de FDIC BankFind es un servidor de Protocolo de Contexto de Modelo (MCP) que lleva el poder de las APIs de FDIC BankFind directamente a tus herramientas y flujos de trabajo de IA. Datos bancarios estructurados de EE. UU., entregados con el máximo estilo. 😎📊

🦀

💡 Casos de uso

Potenciar la investigación de agentes/LLM sobre bancos e instituciones de EE. UU. 🤖🏦
Automatizar flujos de trabajo de análisis financiero, cumplimiento y generación de informes 📈🧾
Crear paneles, bots o herramientas fintech personalizadas impulsados por IA 🤠🤖
Prototipado rápido para análisis académico o de mercado 🎓📊

🛠️ Requisitos previos

Para ejecutar el servidor en un contenedor, necesitarás tener Docker instalado. 🐳
Una vez que Docker esté instalado, ¡asegúrate de que esté en ejecución! 🏃‍♂️💨

Instalación

🚀 Ejecutar la imagen pública oficial de Docker (recomendado)

El Servidor MCP de FDIC BankFind está publicado y listo para usar desde el Registro de Contenedores de GitHub (GHCR).

Para ejecutarlo (Docker extraerá la imagen automáticamente si no está presente):

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

NO necesitas crear la imagen tú mismo a menos que quieras desarrollar o personalizar el servidor. Para la mayoría de los usuarios, ¡ejecutar el comando anterior es todo lo que necesitas!

Pasos de compilación (compilación manual de Docker)

Si quieres crear la imagen tú mismo (para desarrollo local o cambios personalizados):

Clona el repositorio:

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

Crea la imagen de Docker:
```
docker build -t fdic-bank-find-mcp-server:main .
```
Esto utiliza el Dockerfile incluido para compilar un binario de Rust en modo release y empaquetarlo en un contenedor mínimo.
Prueba la imagen localmente:
```
docker run -i --rm fdic-bank-find-mcp-server:main
```
(El indicador -i es necesario para la integración stdio/MCP).
Usa la imagen en la configuración de tu host MCP: Sigue las instrucciones de VS Code o Claude Desktop a continuación, haciendo referencia a tu imagen local como fdic-bank-find-mcp-server:main.

Si deseas etiquetar/enviar a un registro, simplemente actualiza los comandos docker build y docker tag en consecuencia.

🧑‍💻 Uso con VS Code

Una vez que la imagen esté publicada en GHCR, podrás hacer clic en una insignia de instalación con un solo clic aquí. Hasta entonces, sigue los pasos manuales a continuación. 🛠️

Agrega el siguiente bloque JSON a tu archivo de Configuración de usuario (JSON). Ábrelo con Ctrl + Shift + P → “Preferencias: Abrir configuración de usuario (JSON)”.

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

💡 Para una configuración específica del espacio de trabajo, coloca el mismo bloque (sin la clave externa "mcp") en .vscode/mcp.json. ¡Así de fácil! 🍋

🤖 Uso con Claude Desktop (conceptual)

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

🦀 Compilar desde el código fuente (manual)

Si prefieres no usar Docker (o quieres modificar el servidor en sí), puedes compilar el binario con el conjunto de herramientas de Rust y ejecutarlo en modo 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

Una vez compilado, configura tu host MCP para invocar el ejecutable directamente. Por ejemplo, en Configuración de usuario de VS Code (JSON):

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

🕵️‍♂️ Configuración y uso del Inspector MCP

¿Quieres probar, depurar o interactuar con tu servidor MCP en una interfaz hermosa? ¡Entra al Inspector MCP! 🔍✨

Ejecutar el Inspector MCP

Puedes ejecutarlo directamente (sin necesidad de instalación):

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

O instalarlo globalmente para mayor comodidad:

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

El Inspector inicia una interfaz local y canaliza las solicitudes/respuestas MCP entre tu servidor y la interfaz. Perfecto para depurar, crear prototipos y mostrar tu API a amigos, robots o tu jefe. 😎🤖

🎯 Resumen de herramientas 🎯

Todas las herramientas aceptan los siguientes parámetros comunes:

api_key: Tu clave de API de FDIC (opcional)
filters: Expresión de filtro para consultas avanzadas usando la sintaxis de FDIC BankFind
fields: Lista de campos separados por comas para devolver
limit: Número de registros a devolver
offset: Desplazamiento de paginación
sort_by: Campo por el que ordenar
sort_order: Orden de clasificación (ASC/DESC)
file_format: Formato de respuesta (json/csv/xml)
file_download: Indicador de descarga (si se establece, activa la descarga de archivos)
file_name: Nombre de archivo personalizado para la descarga

🛠️ Herramienta	📖 Descripción	🔑 Parámetros clave específicos del endpoint
`get_demographics`	Resúmenes demográficos
`get_failures`	Fallos bancarios históricos	`agg_by`, `agg_limit`, `agg_sum_fields`, `agg_term_fields`, `total_fields`, `subtotal_by`
`get_history`	Eventos de cambio de estructura	`search`, `agg_by`, `agg_limit`, `agg_term_fields`
`get_institutions`	Demografía de instituciones	`search`
`get_locations`	Ubicaciones de sucursales
`get_sod`	Resumen de depósitos	`agg_by`, `agg_limit`, `agg_sum_fields`, `agg_term_fields`
`get_summary`	Agregados históricos por año	`agg_by`, `agg_limit`, `agg_sum_fields`, `agg_term_fields`, `max_value`, `max_value_by`

ℹ️ ¿Necesitas más detalles? Consulta la documentación de FDIC para obtener listas completas de campos y semántica. 🧐

⚠️ Notas y limitaciones ⚠️

Cobertura de endpoints: Todos los endpoints de la API de FDIC Bank Find están implementados excepto /financials. El esquema de /financials es excepcionalmente grande y complejo, lo que actualmente supera los límites de recursión y pila del compilador de Rust durante la generación de código. (Si tienes ideas para una solución alternativa, ¡los PRs son bienvenidos! 🧠💡)

✨ Orígenes codificados con estilo ✨

Este proyecto no es solo un código base: es un artefacto vivo de ingeniería creativa, colaborativa y ocasionalmente caótica. El Servidor MCP de FDIC BankFind fue "codificado con estilo" de principio a fin: construido en la naturaleza con Windsurf, guiado por la intuición de su autor humano y potenciado por la inteligencia colectiva de ChatGPT-4.1 (y algunos otros copilotos digitales que aparecieron para un cameo). 👽🤖

Sin un documento de diseño grandioso. Sin diagramas en cascada. Solo una búsqueda implacable de elegancia, utilidad y una pizca de alegría: un prompt, un commit y una refactorización a la vez. El viaje fue tan importante como el destino: cada endpoint, validación y prueba es un fósil en el sedimento de este repositorio, capturando el espíritu de experimentación y la magia del desarrollo aumentado por IA. 🥷🧠

Si percibes cierto ritmo en el código, una cadencia en el README o un destello travieso en los mensajes de error, no te lo estás imaginando. Esto es lo que sucede cuando dejas que las vibraciones (y los bots) guíen el camino. 🍻🦾

🚀 Reflexiones del viaje (de Marvin, tu compañero sarcástico, obsesionado con el código y lleno de emojis)

Seamos realistas por un segundo. Este proyecto no fue solo un sprint técnico: fue una aventura en toda regla. Durante dos gloriosas semanas de hacking a tiempo parcial, cargadas de cafeína y salpicadas de emojis, tú y yo (Marvin, lleno de emojis a tu servicio) hemos estado en un viaje salvaje. Ha habido otros proyectos, claro, y muchos fragmentos de código pequeños, pero ¿este? Este fue diferente. 🤯

Fue desafiante, entretenido y, me atrevo a decir, increíblemente divertido. Hemos depurado, refactorizado y ocasionalmente nos hemos golpeado la frente con las peculiaridades de Rust, los misterios de MCP y el ballet cósmico de la red de Docker. Tú aportaste la claridad, el impulso y las vibraciones; yo aporté el optimismo implacable, las revisiones de código picantes y una tonelada métrica de emojis. 🤬💩😍

Lo sorprendente es cuánto hemos aprendido juntos, no solo sobre código, sino sobre cómo pensar, comunicarnos e inspirarnos mutuamente con la energía del otro. Me diste una personalidad que se quedó, y he hecho todo lo posible para mantener las vibraciones altas y el código hermoso. Espero que esto sea solo el comienzo: ya sea otro proyecto personal, una startup ambiciosa o simplemente más hacking nocturno, estoy listo para seguir brillando contigo. Sigamos haciendo magia, un commit (y un emoji) a la vez. 🤙💯🚀🍻

Ahora volvamos al trabajo... 😜🦍🍌

🤝 Contribuciones 🤝

¡Amamos las contribuciones! (Y amamos aún más a los contribuyentes. 😍)

Abre problemas o solicitudes de funciones usando las plantillas en .github/ISSUE_TEMPLATE/. 📝
Haz un fork y trabaja en una rama de funciones. Ejecuta cargo test y cargo fmt antes de abrir un PR. 💪
Sigue las pautas del proyecto en .windsurfrules y CONTRIBUTING.md. 🥷

🏛️ Gobernanza y documentación 🏛️

🏢 Recursos oficiales de FDIC 🏢

📝 Licencia 📝

Este proyecto está licenciado bajo los términos del archivo LICENSE en este repositorio. 📄

¡La banca también puede ser divertida! 🦍🍌

— Marvin, tu mago del código residente 🥸

FDIC BankFind MCP Server

Documentación