fd-find-data-business-mcp

유료 사용자에게 FindData 자체 크롤링 데이터를 제공하는 상업용 로그인 게이트 MCP 서버입니다. fd-open-data-mcp를 라이브러리로 의존하며 캐시, 디스패치, 카탈로그를 재사용하지만, 응답에서 업스트림 제공자 식별 정보를 전혀 노출하지 않습니다. 모든 값은 finddata 브랜드로 표시되며, source_used / real_source_used 키는 클라이언트에 절대 도달하지 않습니다.

도구

Related MCP server: xbrl-financial

설치

pip install fd-find-data-business-mcp

실행 (로컬 개발, 인증 없음)

export FD_OPEN_DATA_MCP_DATABASE_URL=postgresql://fd:***@localhost:30432/fd_open_data
fd-find-data-business-mcp serve --transport http --host 0.0.0.0 --port 8310

FDBIZ_JWKS_URI가 설정되지 않으면 인증이 비활성화됩니다(스모크 테스트 / 로컬 개발). 배포 시 설정하면 유효한 Logto 발급 JWT가 없는 모든 요청을 거부합니다(모든 도구 실행 전에 401).

배포 (zihan k3s, 네임스페이스 fd-mcp)

인증은 FastMCP의 JWTVerifier를 통한 Logto(RS256 JWT)입니다. 표준 Logto 인스턴스는 guangzhou-xinru에서 실행됩니다:

이 네 개의 키는 공유 fd-mcp-env Secret에 추가됩니다(이미 FD_OPEN_DATA_MCP_DATABASE_URL / REDIS_URL을 포함 — 비즈니스 포드는 이를 재사용합니다; 형제 포드의 MCP_BEARER_TOKEN은 여기서 비활성이며, 이 포드는 bearer 인증이 아닌 JWT 인증을 사용합니다):

# on zihan (sudo kubectl)
sudo kubectl -n fd-mcp create secret generic fd-mcp-env \
  --from-literal=FD_OPEN_DATA_MCP_DATABASE_URL='postgresql://fd:***@100.64.0.3:30432/fd_open_data' \
  --from-literal=REDIS_URL='redis://:***@100.64.0.3:30380/0' \
  --from-literal=FDBIZ_JWKS_URI='https://auth.finddatatech.cloud/oidc/jwks' \
  --from-literal=FDBIZ_ISSUER='https://auth.finddatatech.cloud/oidc' \
  --from-literal=FDBIZ_AUDIENCE='https://api.finddatatech.cloud/mcp' \
  --dry-run=client -o yaml | sudo kubectl apply -f -
sudo kubectl -n fd-mcp apply -f k8s/zihan/40-fd-find-data-business-mcp.yaml

메시를 통해 http://100.64.0.4:30803/mcp에서 접근 가능합니다 (zihan NodePort 30803).

Logto: API 리소스 등록

Logto 관리 콘솔(https://auth-admin.finddatatech.cloud)에서 식별자 https://api.finddatatech.cloud/mcp를 가진 API 리소스를 생성합니다(이것은 발급된 토큰의 aud 클레임이 되며, FDBIZ_AUDIENCE와 같아야 합니다). 해당 audience에 대해 인증된 클라이언트(M2M 또는 퍼스트파티 SPA)를 생성합니다; 유료 사용자의 토큰은 aud: https://api.finddatatech.cloud/mcp를 포함해야 합니다.

게시

OIDC 신뢰 게시 — v* 태그는 .github/workflows/release.yml을 트리거합니다 (빌드 → twine 검사 → wheel 스모크 테스트 → PyPI 게시). Harbor 이미지는 main / 태그에 대한 push 시 .github/workflows/docker-publish.yml에 의해 빌드됩니다.