FDIC BankFind MCP 서버

fdic-mcp-server는 FDIC BankFind Suite API를 위한 MCP(Model Context Protocol) 서버입니다. 이 서버는 LLM 호스트가 별도의 FDIC API 연동 작업 없이도 FDIC 보험 기관을 검색하고, 공개 은행 기록을 검색하며, 일반적인 다중 은행 분석 워크플로우를 실행할 수 있는 깔끔한 방법을 제공합니다.

이 서버는 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를 재사용합니다.

컨테이너 빌드는 Cloud Run 호환성을 위해 기본적으로 PORT=8080을 사용합니다.

업스트림 FDIC 응답 크기 제한을 재정의하려면 FDIC_MAX_RESPONSE_BYTES를 설정하세요. 기본값은 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 기술

이 저장소에는 여러 FDIC MCP 도구를 구조화된 분석 워크플로우로 연결하는 Claude Code 슬래시 명령이 포함되어 있습니다.

기술은 .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 라이선스에 따라 라이선스가 부여됩니다.