FDIC BankFind MCP 服务器

fdic-mcp-server 是一个用于 FDIC BankFind Suite API 的 MCP（模型上下文协议）服务器。它为 LLM 主机提供了一种简洁的方式来搜索 FDIC 保险机构、检索公共银行记录，并运行常见的跨银行分析工作流，而无需自定义 FDIC API 的底层对接。

当您希望使用支持 MCP 的客户端通过稳定的工具界面和机器可读的响应来回答有关银行、倒闭、分支机构、季度财务、存款数据或同行表现的问题时，它非常有用。

目录

• 项目状态

• 为什么存在此项目

• 文档

• 安装

• 使用方法

• 可用工具

• 数据说明

• 支持

• 贡献

• 许可证

Related MCP server: census-geocoding-mcp

项目状态

活跃开发中。该服务器目前可用，工具界面已通过测试覆盖，但随着客户端支持和分析工作流的改进，项目仍在不断演进。

为什么存在此项目

FDIC BankFind Suite API 是公开且有用的，但它并未开箱即用地为 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 主机支持远程 MCP URL，请使用：

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 传输是基于会话的。客户端初始化一次，然后在后续的 POST、GET 和 DELETE 请求中重用 MCP-Session-Id。

容器构建默认使用 PORT=8080 以实现 Cloud Run 兼容性。

设置 FDIC_MAX_RESPONSE_BYTES 以覆盖上游 FDIC 响应大小限制。默认值为 5242880 字节（5 MiB）。

最小 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。

使用示例

查找北卡罗来纳州资产超过 10 亿美元的活跃银行：

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

获取自 2000 年 1 月 1 日以来损失最惨重的 10 家银行倒闭案例：

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/ 中，任何配置了此 MCP 服务器的 Claude Code 会话均可使用。使用示例请见 docs/usage-examples.md。

数据说明

• 货币价值通常以千美元为单位报告。

• CERT 是稳定的 FDIC 机构标识符。

• 财务和人口统计数据集为季度数据，使用 YYYYMMDD 格式的 REPDTE。

• 汇总数据为年度数据，使用 YEAR。

• SOD 数据是截至 6 月 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

发布版本由 semantic-release 从经过验证的 main 提交自动发布。请勿手动编辑包版本或手动创建发布标签。GitHub Releases 是已发布版本的权威发布记录。

许可证

本项目采用 MIT 许可证授权。