fd-find-data-business-mcp

商用・ログイン必須のMCPサーバーで、FindData自身がクロールしたデータを有料ユーザーに提供します。ライブラリとして 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、namespace fd-mcp）

認証は、FastMCPの JWTVerifier を介したLogto（RS256 JWT）です。正規のLogtoインスタンスはguangzhou-xinru上で実行されます：

これらの4つのキーは、共有の fd-mcp-env Secret に追加されます（FD_OPEN_DATA_MCP_DATABASE_URL / REDIS_URL はすでに含まれており、ビジネスポッドはそれらを再利用します。兄弟ポッドの MCP_BEARER_TOKEN はここでは無効で、このポッドはベアラー認証ではなく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 と一致する必要があります）。そのオーディエンスに対して承認されたクライアント（M2MまたはファーストパーティSPA）を作成します。有料ユーザーのトークンは aud: https://api.finddatatech.cloud/mcp を保持している必要があります。

公開

OIDCトラステッドパブリッシング — v* タグが .github/workflows/release.yml をトリガーします（ビルド → twine check → wheelスモークテスト → PyPIへの公開）。Harborイメージは .github/workflows/docker-publish.yml によって main / タグへのプッシュ時にビルドされます。