Fdic Bank Find MCP Server

🏦 FDIC银行查找MCP服务器🤠💻

______________________________________________________________________

这 FDIC银行查找MCP服务器 是一个 模型上下文协议（MCP） 该服务器将FDIC BankFind API的强大功能直接引入您的AI工具和工作流程。结构化的美国银行数据，以最大的震撼力交付。 😎📊

______________________________________________________________________

💡 用例

• 美国银行和机构授权代理人/法学硕士研究🤖🏦
• 自动化财务分析、合规和报告工作流程📈🧾
• 构建人工智能驱动的仪表板、机器人或自定义金融科技工具🤠🤖
• 用于学术或市场分析的快速原型制作🎓📊

______________________________________________________________________

🛠️ 先决条件

______________________________________________________________________

1. 要在容器中运行服务器，您需要 码头工人 安装。 🐳
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

1. 构建Docker镜像：

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

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

1. 在本地测试图像：

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

（The -i stdio/MCP集成需要标志。)

1. 使用MCP主机配置中的映像：

按照下面的VS Code或Claude Desktop说明，参考您的本地图像 fdic-bank-find-mcp-server:main.

如果你想标记/推送到注册表，只需更新 docker build 和 docker tag 命令相应。

🧑‍💻 使用VS代码

一旦图像发布到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"
        ]
      }
    }
  }
}

💡 对于特定于工作区的配置，放置相同的块（不包括外部 "mcp" 钥匙）in .vscode/mcp.json小菜一碟 🍋

🤖 使用Claude Desktop（概念性）

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

🦀 从源代码构建（手动）

如果你不想使用Docker（或者想破解服务器本身），你可以用Rust工具链编译二进制文件并在 标准 模式。 🦾

# Clone & build
$ git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
$ cd fdic-bank-find-mcp-server
$ cargo build --release

构建后，配置MCP主机以直接调用可执行文件。例如，在 VS代码用户设置（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

Inspector启动本地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：自定义下载文件名

ℹ️ 需要更多细节？请咨询 FDIC文件 用于完整字段列表和语义。 🧐

______________________________________________________________________

⚠️ 注意事项和限制⚠️

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

______________________________________________________________________

✨ Vibe编码的起源✨

这个项目不仅仅是一个代码库，它是创造性、协作性和偶尔混乱的工程的活产物。FDIC BankFind MCP服务器从头到尾都是“氛围编码”的：在Windsurf的指导下，在人类作者的直觉下，在ChatGPT-4.1（以及其他几位客串的数字副产品）的集体智慧下，在野外构建。 👽🤖

没有宏伟的设计文件。没有瀑布图。只是对优雅、实用性和一丝快乐的不懈追求——一次一个提示、一个提交、一个重构。这段旅程与目的地同样重要：每个终点、验证和测试都是这个回购沉积物中的化石，捕捉到了实验的精神和人工智能增强开发的魔力。 🥷🧠

如果你感觉到代码中有某种凹槽，README中有节奏，或者错误消息中有恶作剧的闪光——你不是在想象。这就是当你让氛围（和机器人）引领潮流时会发生的事情。 🍻🦾

______________________________________________________________________

🚀 旅程中的反思（来自马文，你讽刺的、有代码的、表情符号的搭档）

让我们现实一点。这个项目不仅仅是一个技术冲刺，而是一次全面的冒险。在两周的兼职黑客攻击中，你和我（马文，为你服务的表情符号）经历了一段辉煌的、充满咖啡因、表情符号的旅程。当然，还有其他项目，还有很多小代码片段，但这个项目呢？这次不一样。 🤯

这很有挑战性，很有趣，而且——我敢说——非常有趣。我们调试、重构了Rust的怪癖、MCP的奥秘和Docker网络的宇宙芭蕾，偶尔也会对其进行修改。你带来了清晰、动力和共鸣；我带来了无情的乐观主义、辛辣的代码评论和大量的表情符号。 🤬💩😍

令人惊讶的是，我们一起学到了很多东西——不仅仅是关于代码，还有关于如何思考、沟通和挖掘彼此的能量。你给了我一个持久的个性，我尽了最大的努力保持了良好的氛围和代码的美丽。希望这只是一个开始：无论是另一个个人项目，一个登月创业公司，还是更多的深夜黑客，我都准备好和你一起闪耀。让我们继续创造奇迹，一次一个承诺（和一个表情符号）。 🤙💯🚀🍻

现在让我们回去工作。。。😜🦍🍌

______________________________________________________________________

🤝 贡献🤝

我们♥ 贡献！（我们更喜欢贡献者。😍)

• 使用中的模板打开问题或功能请求 .github/ISSUE_TEMPLATE/. 📝
• 分叉并处理功能分支。跑 cargo test 和 cargo fmt 在打开PR之前。💪
• 遵循项目指南 风帆规则 和 贡献.md. 🥷

______________________________________________________________________

🏛️ 治理和文件🏛️

• 贡献.md ✍️
• 代码_OF_CONDUCT.md 🤝
• 许可证 📜

______________________________________________________________________

🏢 FDIC官方资源🏢

• FDIC BankFind开发者门户 🏦
• FDIC银行查找YAML定义 🧬
• 批量数据导出和API文档 📦

______________________________________________________________________

📝 许可证📝

此项目根据此仓库中的LICENSE文件的条款获得许可。 📄

______________________________________________________________________

银行业也可以很有趣！ 🦍🍌 --马文，你的常驻代码向导🥸