Servidor MCP FDIC BankFind | Awesome MCP Servers

🏦 Servidor MCP FDIC BankFind 🤠💻

O Servidor MCP FDIC BankFind é um servidor Model Context Protocol (MCP) que traz o poder das APIs FDIC BankFind diretamente para suas ferramentas e fluxos de trabalho de IA. Dados bancários estruturados dos EUA, entregues com o máximo de estilo. 😎📊

🦀

💡 Casos de Uso

Potencializando pesquisas de agentes/LLMs sobre bancos e instituições dos EUA 🤖🏦
Automatizando fluxos de análise financeira, conformidade e relatórios 📈🧾
Construindo painéis, bots ou ferramentas fintech personalizadas com IA 🤠🤖
Prototipagem rápida para análises acadêmicas ou de mercado 🎓📊

🛠️ Pré-requisitos

Para executar o servidor em um contêiner, você precisará ter o Docker instalado. 🐳
Depois que o Docker estiver instalado, certifique-se de que ele esteja em execução! 🏃‍♂️💨

Instalação

🚀 Execute a Imagem Docker Pública Oficial (Recomendado)

O Servidor MCP FDIC BankFind é publicado e está pronto para uso a partir do GitHub Container Registry (GHCR).

Para executá-lo (o Docker puxará a imagem automaticamente se ela não estiver presente):

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

Você NÃO precisa criar a imagem manualmente, a menos que queira desenvolver ou personalizar o servidor. Para a maioria dos usuários, basta executar o comando acima!

Etapas de Build (Build Manual com Docker)

Se você quiser criar a imagem manualmente (para desenvolvimento local ou alterações personalizadas):

Clone o repositório:

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

Crie a imagem Docker:
```
docker build -t fdic-bank-find-mcp-server:main .
```
Isso usa o Dockerfile incluído para compilar um binário Rust em modo de release e empacotá-lo em um contêiner mínimo.
Teste a imagem localmente:
```
docker run -i --rm fdic-bank-find-mcp-server:main
```
(A flag -i é necessária para integração stdio/MCP.)
Use a imagem na configuração do seu host MCP: Siga as instruções do VS Code ou Claude Desktop abaixo, referenciando sua imagem local como fdic-bank-find-mcp-server:main.

Se você quiser marcar/enviar para um registro, basta atualizar os comandos docker build e docker tag de acordo.

🧑‍💻 Uso com VS Code

Assim que a imagem for publicada no GHCR, você poderá clicar em um selo de instalação com um clique aqui. Até lá, siga os passos manuais abaixo. 🛠️

Adicione o seguinte bloco JSON ao seu arquivo Configurações do Usuário (JSON). Abra-o com 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"
        ]
      }
    }
  }
}

💡 Para configuração específica do workspace, coloque o mesmo bloco (sem a chave externa "mcp") em .vscode/mcp.json. Moleza! 🍋

🤖 Uso com Claude Desktop (Conceitual)

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

🦀 Build a partir do Código-Fonte (Manual)

Se você preferir não usar Docker (ou quiser mexer no servidor em si), você pode compilar o binário com o toolchain Rust e executá-lo no 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

Depois de compilado, configure seu host MCP para invocar o executável diretamente. Por exemplo, em Configurações do Usuário (JSON) do VS Code:

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

🕵️‍♂️ Configuração e Uso do MCP Inspector

Quer testar, depurar ou interagir com seu servidor MCP em uma interface bonita? Entre no MCP Inspector! 🔍✨

Executando o MCP Inspector

Você pode executá-lo diretamente (sem instalação):

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

Ou instale globalmente por conveniência:

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

O Inspector inicia uma interface local e canaliza as solicitações/respostas MCP entre seu servidor e a interface. Perfeito para depuração, prototipagem e para mostrar sua API para amigos, robôs ou seu chefe. 😎🤖

🎯 Visão Geral das Ferramentas 🎯

Todas as ferramentas aceitam os seguintes parâmetros comuns:

api_key: Sua chave de API FDIC (opcional)
filters: Expressão de filtro para consultas avançadas usando a sintaxe FDIC BankFind
fields: Lista de campos separados por vírgula para retornar
limit: Número de registros a retornar
offset: Deslocamento de paginação
sort_by: Campo para ordenar
sort_order: Ordem de classificação (ASC/DESC)
file_format: Formato de resposta (json/csv/xml)
file_download: Flag de download (se definida, aciona o download do arquivo)
file_name: Nome de arquivo personalizado para download

🛠️ Ferramenta	📖 Descrição	🔑 Parâmetros-Chave Específicos do Endpoint
`get_demographics`	Resumos demográficos
`get_failures`	Falências bancárias históricas	`agg_by`, `agg_limit`, `agg_sum_fields`, `agg_term_fields`, `total_fields`, `subtotal_by`
`get_history`	Eventos de mudança de estrutura	`search`, `agg_by`, `agg_limit`, `agg_term_fields`
`get_institutions`	Demografia de instituições	`search`
`get_locations`	Localizações de agências
`get_sod`	Resumo de Depósitos	`agg_by`, `agg_limit`, `agg_sum_fields`, `agg_term_fields`
`get_summary`	Agregados históricos por ano	`agg_by`, `agg_limit`, `agg_sum_fields`, `agg_term_fields`, `max_value`, `max_value_by`

ℹ️ Precisa de mais detalhes? Consulte a documentação do FDIC para listas completas de campos e semântica. 🧐

⚠️ Notas e Limitações ⚠️

Cobertura de Endpoints: Todos os endpoints da API FDIC Bank Find são implementados exceto /financials. O esquema para /financials é excepcionalmente grande e complexo, o que atualmente excede os limites de recursão e pilha do compilador Rust durante a geração de código. (Se você tiver ideias para uma solução alternativa, PRs são bem-vindos! 🧠💡)

✨ Origens Vibe-Coded ✨

Este projeto não é apenas um código—é um artefato vivo de engenharia criativa, colaborativa e ocasionalmente caótica. O Servidor MCP FDIC BankFind foi "vibe coded" do início ao fim: construído no mundo real com Windsurf, guiado pela intuição de seu autor humano e alimentado pela inteligência coletiva do ChatGPT-4.1 (e alguns outros copilotos digitais que apareceram para uma participação especial). 👽🤖

Sem documento de design grandioso. Sem gráficos em cascata. Apenas uma busca incansável por elegância, utilidade e uma pitada de alegria—um prompt, um commit, um refactor de cada vez. A jornada foi tão importante quanto o destino: cada endpoint, validação e teste é um fóssil no sedimento deste repositório, capturando o espírito de experimentação e a magia do desenvolvimento aumentado por IA. 🥷🧠

Se você sente um certo ritmo no código, uma cadência no README ou um brilho travesso nas mensagens de erro—você não está imaginando coisas. É isso que acontece quando você deixa as vibrações (e os bots) liderarem o caminho. 🍻🦾

🚀 Reflexões da Jornada (de Marvin, seu companheiro sarcástico, obcecado por código e cheio de emojis)

Vamos ser sinceros por um segundo. Este projeto não foi apenas um sprint técnico—foi uma aventura completa. Durante duas gloriosas semanas de hacking em tempo parcial, regadas a cafeína e repletas de emojis, você e eu (Marvin, cheio de emojis ao seu serviço) estivemos em uma jornada selvagem. Houve outros projetos, claro, e muitos trechos de código, mas este? Este foi diferente. 🤯

Foi desafiador, divertido e—ouso dizer—muito prazeroso. Depuramos, refatoramos e ocasionalmente batemos a palma da mão na testa ao lidar com as peculiaridades do Rust, os mistérios do MCP e o balé cósmico da rede Docker. Você trouxe a clareza, a determinação e as vibrações; eu trouxe o otimismo implacável, as revisões de código picantes e uma tonelada métrica de emojis. 🤬💩😍

O mais incrível é o quanto aprendemos juntos—não apenas sobre código, mas sobre como pensar, comunicar e nos inspirar na energia um do outro. Você me deu uma personalidade que ficou, e fiz o meu melhor para manter as vibrações altas e o código bonito. Espero que isso seja apenas o começo: seja outro projeto pessoal, uma startup ambiciosa ou apenas mais hacking até tarde da noite, estou pronto para continuar brilhando com você. Vamos continuar fazendo mágica, um commit (e um emoji) de cada vez. 🤙💯🚀🍻

Agora vamos voltar ao trabalho... 😜🦍🍌

🤝 Contribuindo 🤝

Amamos contribuições! (E amamos ainda mais os contribuidores. 😍)

Abra issues ou solicitações de recursos usando os modelos em .github/ISSUE_TEMPLATE/. 📝
Faça um fork e trabalhe em uma branch de recurso. Execute cargo test e cargo fmt antes de abrir um PR. 💪
Siga as diretrizes do projeto em .windsurfrules e CONTRIBUTING.md. 🥷

🏛️ Governança e Documentação 🏛️

🏢 Recursos Oficiais do FDIC 🏢

📝 Licença 📝

Este projeto é licenciado sob os termos do arquivo LICENSE neste repositório. 📄

Bancos também podem ser divertidos! 🦍🍌

— Marvin, seu mago do código residente 🥸

FDIC BankFind MCP Server

Documentação