FDIC BankFind MCP Server

fdic-mcp-server — это MCP-сервер (Model Context Protocol) для API FDIC BankFind Suite. Он предоставляет хостам LLM удобный способ поиска застрахованных FDIC учреждений, получения общедоступных банковских записей и выполнения стандартных рабочих процессов анализа нескольких банков без необходимости сложной интеграции с API FDIC.

Он полезен, когда вам нужно, чтобы MCP-совместимый клиент отвечал на вопросы о банках, банкротствах, филиалах, квартальных финансовых отчетах, данных о депозитах или результатах деятельности аналогов, используя стабильный набор инструментов и машиночитаемые ответы.

Содержание

• Статус проекта

• Зачем нужен этот проект

• Документация

• Установка

• Использование

• Доступные инструменты

• Примечания к данным

• Поддержка

• Участие в разработке

• Лицензия

Related MCP server: census-geocoding-mcp

Статус проекта

Активная разработка. Сервер готов к использованию, набор инструментов покрыт тестами, но проект продолжает развиваться по мере улучшения поддержки клиентов и рабочих процессов анализа.

Зачем нужен этот проект

API FDIC BankFind Suite является общедоступным и полезным, но он не упакован для 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-хост поддерживает удаленные URL-адреса MCP, используйте:

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-транспорт основан на сессиях. Клиенты инициализируются один раз, а затем повторно используют MCP-Session-Id в последующих запросах POST, GET и DELETE.

Контейнерные сборки по умолчанию используют PORT=8080 для совместимости с Cloud Run.

Установите FDIC_MAX_RESPONSE_BYTES, чтобы переопределить ограничение размера ответа FDIC. Значение по умолчанию — 5242880 байт (5 МБ).

Минимальная конфигурация 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.

Примеры использования

Поиск активных банков в Северной Каролине с активами более 1 миллиарда долларов:

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

Получение 10 самых дорогостоящих банкротств банков с 1 января 2000 года:

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

Сравнение банков Северной Каролины между двумя датами квартальных отчетов:

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

Этот репозиторий включает слэш-команду Claude Code, которая объединяет несколько инструментов FDIC MCP в структурированный рабочий процесс анализа.

Навыки определены в .claude/commands/ и доступны для любой сессии Claude Code с настроенным этим MCP-сервером. См. docs/usage-examples.md для примера использования.

Примечания к данным

• Денежные значения обычно указываются в тысячах долларов.

• CERT — это стабильный идентификатор учреждения FDIC.

• Наборы финансовых и демографических данных являются квартальными и используют REPDTE в формате YYYYMMDD.

• Сводные данные являются годовыми и используют YEAR.

• Данные SOD — это годовые данные на уровне филиалов по состоянию на 30 июня.

• Не смешивайте квартальные финансовые данные и годовые данные филиалов без указания основы даты.

Поддержка

Используйте систему отслеживания проблем GitHub для сообщений об ошибках, проблем с документацией и запросов функций: 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

Релизы публикуются автоматически из проверенных коммитов main с помощью semantic-release. Не редактируйте версию пакета вручную и не создавайте теги релизов вручную. GitHub Releases является авторитетной записью о релизах для опубликованных версий.

Лицензия

Этот проект лицензирован по лицензии MIT.