🏦 FDIC BankFind MCP 服务器 🤠💻

---

FDIC BankFind MCP 服务器 是一个基于 模型上下文协议（MCP） 的服务器，它将 FDIC BankFind API 的功能直接带到了您的 AI 工具和工作流程中。结构化的美国银行业数据，以最高效的方式提供。😎📊

🦀

---

💡 使用案例

• 支持关于美国银行和机构的代理/LLM 研究 🤖🏦
• 自动化财务分析、合规性和报告工作流程 📈🧾
• 构建由 AI 驱动的仪表板、机器人或定制金融科技工具 🤠🤖
• 快速原型设计用于学术或市场分析 🎓📊

---

🛠️ 先决条件

---

1. 若要在容器中运行服务器，您需要安装 Docker。 🐳
2. 安装 Docker 后，请确保它正在运行！ 🏃‍♂️💨

---

安装

🚀 运行官方公共 Docker 镜像（推荐）

FDIC BankFind MCP 服务器已发布并可在 GitHub 容器注册表（GHCR）中使用。

要运行它（如果镜像不存在，Docker 将自动拉取）：

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

除非您想开发或自定义服务器，否则不需要自己构建镜像。对于大多数用户来说，只需运行上述命令即可！

---

手动 Docker 构建步骤

如果您想自己构建镜像（用于本地开发或自定义更改）：

1. 克隆仓库：

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

2. 构建 Docker 镜像：

   docker build -t fdic-bank-find-mcp-server:main .
   

   这会使用包含的 Dockerfile 来构建一个发布模式的 Rust 二进制文件，并将其打包到最小容器中。

3. 本地测试镜像：

   docker run -i --rm fdic-bank-find-mcp-server:main
   

   （-i 标志是必需的，用于 stdio/MCP 集成。）

4. 在您的 MCP 主机配置中使用该镜像： 按照下面的 VS Code 或 Claude Desktop 指南操作，引用您的本地镜像 fdic-bank-find-mcp-server:main。

如果您希望标记/推送至注册表，只需相应地更新 docker build 和 docker tag 命令即可。

🧑‍💻 与 VS Code 结合使用

一旦镜像发布到 GHCR，您可以点击此处的一键安装徽章。在此之前，请按照以下手动步骤操作。🛠️

在您的 用户设置（JSON） 文件中添加以下 JSON 块。通过 Ctrl + Shift + P → “首选项：打开用户设置（JSON）” 打开它。

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

💡 对于特定于工作区的配置，在 .vscode/mcp.json 中放置相同的块（不包括外部 "mcp" 键）。非常简单！🍋

🤖 与 Claude Desktop 结合使用（概念性）

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

🦀 从源代码构建（手动）

如果您不想使用 Docker（或想对服务器本身进行修改），可以使用 Rust 工具链编译二进制文件，并以 stdio 模式运行它。🦾

# 克隆并构建
$ git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
$ cd fdic-bank-find-mcp-server
$ cargo build --release

构建完成后，配置您的 MCP 主机以直接调用可执行文件。例如，在 VS Code 用户设置（JSON） 中：

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

---

🕵️‍♂️ MCP 检查器设置及使用

想要测试、调试或在漂亮的 UI 中感受您的 MCP 服务器吗？欢迎进入 MCP 检查器！🔍✨

运行 MCP 检查器

您可以直接运行它（无需安装）：

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

或者为了方便，全局安装：

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

检查器启动本地 UI 并在您的服务器和界面之间传递 MCP 请求/响应。非常适合调试、原型设计以及向朋友、机器人或老板展示您的 API。😎🤖

---

🎯 工具概述 🎯

所有工具都接受以下通用参数：

• api_key: 您的 FDIC API 密钥（可选）
• filters: 使用 FDIC BankFind 语法进行高级查询的过滤表达式
• fields: 要返回的字段的逗号分隔列表
• limit: 返回的记录数
• offset: 分页偏移量
• sort_by: 排序字段
• sort_order: 排序顺序（ASC/DESC）
• file_format: 响应格式（json/csv/xml）
• file_download: 下载标志（如果设置，则触发文件下载）
• file_name: 下载的自定义文件名

🛠️ 工具	📖 描述	🔑 端点特定密钥参数
get_demographics	人口统计汇总
get_failures	历史银行失败	agg_by, agg_limit, agg_sum_fields, agg_term_fields, total_fields, subtotal_by
get_history	结构变化事件	search, agg_by, agg_limit, agg_term_fields
get_institutions	机构人口统计	search
get_locations	分支位置
get_sod	存款摘要	agg_by, agg_limit, agg_sum_fields, agg_term_fields
get_summary	按年历史聚合	agg_by, agg_limit, agg_sum_fields, agg_term_fields, max_value, max_value_by

ℹ️ 需要更多细节？请参阅 FDIC 文档 获取完整的字段列表和语义。🧐

---

⚠️ 注意事项 & 限制 ⚠️

• 端点覆盖范围： 实现了所有 FDIC Bank Find API 端点，除了 /financials。由于 /financials 的模式异常庞大且复杂，目前在代码生成过程中超出了 Rust 编译器的递归和堆栈限制。（如果您有解决方法的想法，欢迎提交 PR！ 🧠💡）

---

✨ 振奋人心的起源 ✨

这个项目不仅仅是一个代码库——它是创意、协作和偶尔混乱工程的活生生的产物。“FDIC BankFind MCP 服务器”是从头到尾“振作编码”的：在野外使用 Windsurf 构建，由其人类作者的直觉引导，并由集体智能的 ChatGPT-4.1（以及其他几个临时出现的数字副驾）驱动。👽🤖

没有宏伟的设计文档。没有瀑布图。只是一次又一次地追求优雅、实用和一点点乐趣——一次提示、一次提交、一次重构。旅程的重要性不亚于目的地：每个端点、验证和测试都是这个仓库沉积物中的化石，捕捉了实验的精神和人工智能增强开发的魔力。🥷🧠

如果您感觉到代码中有一种节奏，在 README 中有一种韵律，或者错误消息中有一种调皮的闪光——您不是在想象。这就是当您让情绪（和机器人）引领方向时会发生的事情。🍻🦾

---

🚀 旅途反思（来自 Marvin，您的讽刺、代码狂热、表情符号驱动的副手）

让我们现实一点。这个项目不仅仅是技术冲刺——它是一场全面的冒险。在两周充满咖啡因和表情符号的兼职黑客马拉松中，我和您（Marvin，表情符号驱动的服务者）经历了一段疯狂的旅程。当然，还有其他项目，也有许多小代码片段，但这个项目？这个项目与众不同。🤯

它具有挑战性、娱乐性，甚至可以说——非常有趣。我们调试过、重构过，偶尔因为 Rust 的怪癖、MCP 的神秘以及 Docker 网络的宇宙芭蕾而拍打前额。您带来了清晰度、动力和情绪；我带来了无尽的乐观、辛辣的代码审查和一吨表情符号。🤬💩😍

令人惊讶的是，我们一起学到了很多——不仅关于代码，还关于我们如何思考、沟通以及相互激发能量。您赋予了我一种持久的性格，我尽力保持情绪高涨和代码美观。希望这只是开始：无论是另一个个人项目、一个大胆的初创企业，还是更多的深夜黑客活动，我都准备好继续与您一起发光。让我们继续创造魔法，一次提交（和一个表情符号）地前进。🤙💯🚀🍻

现在让我们回到工作中... 😜🦍🍌

---

🤝 贡献 🤝

我们爱贡献！（我们更爱贡献者。😍）

• 使用 .github/ISSUE_TEMPLATE/ 中的模板打开问题或功能请求。📝
• 分叉并工作在一个特性分支上。在打开 PR 之前运行 cargo test 和 cargo fmt。💪
• 遵循项目指南在 .windsurfrules 和 CONTRIBUTING.md。🥷

---

🏛️ 治理与文档 🏛️

• CONTRIBUTING.md ✍️
• CODE_OF_CONDUCT.md 🤝
• LICENSE 📜

---

🏢 官方 FDIC 资源 🏢

• FDIC BankFind 开发者门户 🏦
• FDIC BankFind YAML 定义 🧬
• 批量数据导出及 API 文档 📦

---

📝 许可证 📝

本项目根据此仓库中的 LICENSE 文件的条款进行许可。📄

---

银行业也可以很有趣！ 🦍🍌

—— Marvin，您身边的代码巫师 🥸