FINOS MCP - FDC3 (community)

finos-mcp

AI アシスタントが、3 つのオープンな金融業界標準を正確に調べられるようにします。変更は一切できません。

質問から始める

やりたいこと	選ぶサーバー	動作例
AI ガバナンスのリスクと管理策を、追跡可能な参照情報とともに見つける	AIGF	ガバナンスの例
取引フィールドを理解する、または CDM JSON を検証する	CDM	CDM の例
金融商品に適したデスクトップインテントを見つける	FDC3	FDC3 の例

公式 MCP Registry（公開済み v0.3.2）： AIGF · CDM · FDC3。 3 つともローカルの stdioパッケージであり、一般公開されたホスト型エンドポイントではありません。

Claude Code ですぐに接続： Claude Code と uv をインストールした状態で、必要な標準に応じて以下のコマンドから1 つ実行します。

claude mcp add --scope user finos-aigf -- uvx --python 3.12 finos-mcp-aigf==0.3.2
claude mcp add --scope user finos-cdm -- uvx --python 3.12 finos-mcp-cdm==0.3.2
claude mcp add --scope user finos-fdc3 -- uvx --python 3.12 finos-mcp-fdc3==0.3.2

claude mcp list を実行してから、アシスタントに get_control （AIGF）、describe_type（CDM）、または suggest_intent（FDC3）を使うよう依頼します。 クライアント設定ガイドには、Claude Desktop、VS Code、Copilot向けの、テスト済みの JSON 設定例と、Windows および macOS のトラブルシューティングも記載されています。

モデルや API キーなしで実際の MCP 呼び出しを確認するには、このリポジトリをクローンし、 uv sync --all-packages を実行してから、次を試してください。

uv run --no-sync python examples/try_it.py aigf

テスト済みの使用例レシピから、ほかの 2 つのサーバーのいずれかを選んでください。 これは独立したコミュニティソフトウェアであり、FINOS の公式製品ではありません。

これは何ですか？

銀行などの金融機関は、Fintech Open Source Foundation である FINOS が公開するオープンスタンダードを共有しています。ここでは、そのうち次の3つが重要です。

• AI Governance Framework：金融における AI 利用のリスクと、それを軽減するための 対策をまとめたカタログです。
• Common Domain Model（CDM）：取引と、その後に起こることを記述するための共通の方法です。
• FDC3：デスクトップ金融アプリケーション同士の通信を可能にする標準です。

これらの標準について質問された AI アシスタントは、記憶を頼りに回答して、存在しない ID やスキーマにないフィールドなど、誤った情報を伝えることがよくあります。このプロジェクトでは、アシスタントが実際の情報を参照できるようにします。各標準を、Claude などのアシスタントが外部ツールを呼び出すために使うオープンプロトコルであるModel Context Protocol（MCP）に対応した、小規模なサーバーとしてパッケージ化しています。

サーバーに接続すると、アシスタントは次のような質問に回答できます。

• 「プロンプトインジェクションのリスクを軽減する対策はどれですか。また、それらは EU AI Act のどの項目に対応していますか？」
• 「この取引 JSON は CDM として有効ですか。有効でない場合、具体的にどこが誤っていますか？」
• 「アプリで株式ティッカーが選択されています。ユーザーに提示できる FDC3 アクションはどれですか？」

回答にはそれぞれ、読者が標準そのものと照合できる識別子やリンクが含まれます。

3つのサーバー

サーバー	標準	アシスタントができること
finos-mcp-aigf	AI Governance Framework	公開されている ID を使って24のリスクと25の対策を調べ、対策がどのリスクに対応するかを確認し、13の外部フレームワーク（NIST、ISO 42001、EU AI Act、OWASP）と相互参照し、自然な言葉で検索できます
finos-mcp-cdm	Common Domain Model	767の CDM 型と1,143の JSON スキーマを調べ、商品や取引イベントを参照し、正確なエラーパスを示して取引文書を検証できます
finos-mcp-fdc3	FDC3	19の標準アクション（「インテント」）と28のデータ型を調べ、データオブジェクトを確認し、適合するアクションを提案できます

3つすべてが、以下で説明する安全ルールを備えた共通パッケージであるfinos-mcp-coreを基盤としています。29のツールの全リストはdocs/tools.mdに、CDM サーバーが取引文書内の意図的な誤りを3つ見つける実際のセッションはdocs/demo.mdに掲載されています。

クイックスタート

必要なのはuvだけです。アカウント、API キー、データベースの設定は不要です。

初回セットアップ： Claude Desktop、Claude Code、VS Code、GitHub Copilot 向けの、コピーして貼り付けられるバージョン固定済み設定については、MCP クライアントのセットアップガイドに従ってください。Windows と macOS のセットアップ、実際のツール呼び出しの確認、トラブルシューティングについても説明しています。以下のクイックスタート例では、公開済みで、エンドツーエンドのテストを完了した v0.3.2 のパッケージを固定しています。

Claude Desktop または Claude Code。 これを MCP 設定に追加し（完全な例）、再起動してください。

{
  "mcpServers": {
    "finos-aigf": { "command": "uvx", "args": ["--python", "3.12", "finos-mcp-aigf==0.3.2"] }
  }
}

コマンドラインから実行する場合。

# talk over stdin/stdout, the way desktop assistants connect
uvx --python 3.12 finos-mcp-aigf==0.3.2

# or serve HTTP on localhost (self-hosted, not a public hosted service)
uvx --python 3.12 finos-mcp-aigf==0.3.2 --transport streamable-http --port 8000

コンテナーとして実行する場合。 書き込み可能なディスクも、追加の権限も必要ありません。

docker run --rm -p 8000:8000 --read-only --cap-drop ALL \
  -e FINOS_MCP_ALLOWED_HOSTS='localhost:*,127.0.0.1:*' \
  ghcr.io/vardhjain/finos-mcp:v0.3.2

許可ホスト設定により、ほかのホスト名で届いたリクエストをサーバーが拒否します。これによって、ブラウザー内のウェブページがポートにアクセスするのを防ぎます。

stdio コマンドを直接実行すると、クライアントを待ち受けるサーバーが起動します。チャット用のプロンプトが表示されるわけではありません。ターミナルでインストールを確認するには、代わりに --help を追加してください。ほかのサーバーを実行する場合は、finos-mcp-aigf を finos-mcp-cdm または finos-mcp-fdc3 に置き換えてください。 examples/には、低メモリで再現可能なライブデモ、短い Python クライアント、LangGraph エージェントが含まれています。

接続が安全な理由

アシスタントに新しいツールを与えることにはリスクがあるため、サーバーは意図的に制限されています。

• 読み取りのみ可能です。 どのツールもファイルへの書き込み、メッセージの送信、システムの変更は行いません。いずれかのツールが読み取り専用としてマークされていない場合、サーバーはツールの提供を拒否します。
• オフラインで動作します。 標準はビルド時にパッケージへコピーされ、正確な上流バージョンが記録されます。サーバーの実行中に何かを取得することはありません。
• 過剰な呼び出しを防止します。 すべてのツールにレート制限と入出力サイズの上限があります。
• 誤りの理由を説明します。 不適切なリクエストには、何が問題で何を試せばよいかを示す構造化エラーが返されるため、アシスタントは推測するのではなく自ら修正できます。
• すべて記録されます。 各呼び出しは監査ログに記録され、生の内容の代わりに引数のフィンガープリントが保存されます。

すべての設定を含む詳細は、docs/safety.md に記載されています。

ネットワークを使用するオプション機能が1つあります。semantic エクストラをインストールすると、意味ベースの検索が追加され、初回使用時に小さなオープンモデルがダウンロードされます。この機能がない場合、検索はキーワードベースで完全にオフラインです。

動作の品質

これらの数値は自動チェックで測定され、metrics ブランチに公開されています。上記のバッジはそのファイルを直接参照しているため、特定のコミット時点の測定値が表示されます。

チェック	結果
自動テスト	200件以上が成功し、コードの90％以上がテストされています。正確な数値は上記のバッジに記載されています
平易な言葉での質問に対して適切なレコードを見つける精度（50問）	91.5％の確率で、上位5件以内に正解が含まれます
サーバーを通じてAIモデルが20件のガバナンスに関する質問に回答	架空のIDは0件。回答の95％で有効なIDが引用されました
ツール呼び出しあたりの応答時間	ベンチマーク対象のツールでは数ミリ秒

オフラインのメトリクスは main へのプッシュごとに更新されます。この表の検索結果は2026年10月時点のものです。エージェントのテストではClaude Haiku 4.5を使用し、有料のAnthropic APIクレジットが必要です。予期しない費用を防ぐため、GitHub Actionsで明示的に手動オプトインした場合にのみ実行され、スケジュール実行やPRラベルによる実行はありません。公開されている数値は、2026年9月14日に最後に成功した評価のものであり、リアルタイムのデータではありません。決定論的なテストと検索評価は、LLM APIを呼び出さずにCIで引き続き実行されます。

このプロジェクトの構築では、上流の標準に15件の不具合があることも判明し、docs/upstream-findings.md に記録されています。最初の不具合はFINOSに報告され、YAMLの修正が2026年10月21日にPR #380で上流にマージされました。

プロジェクト構成

パス	内容
core/	共通の安全レイヤー：読み取り専用の強制、レート制限、サイズ上限、監査ログ、検索
servers/	標準ごとのパッケージ。それぞれに上流のコンテンツのコピーを含みます
evals/	ゴールデンテスト、AIGF検索、オフラインCDM/FDC3ワークフロー、レイテンシー、オプションのエージェント評価
examples/	設定とクライアントのサンプル
docs/	ドキュメント。https://vardhjain.github.io/finos-mcp/ でも公開されています

開発

uv sync --all-packages --all-extras
uv run pytest
uv run pytest evals/offline/test_workflows.py -v  # 16 multi-tool scenarios, no paid APIs
uv run ruff check . && uv run mypy core/src servers/*/src

基本ルールについてはCONTRIBUTING.md、各リリースの変更内容についてはCHANGELOG.md、リリースの作成方法についてはRELEASING.md、当初の設計記録についてはPLAN.mdを参照してください。

ステータス

メンテナー向けの情報として、MCP ディレクトリとレジストリのステータスには、すでに公開されている公式レジストリの3件の掲載と、対応待ちのGlama掲載情報の修正が記録されています。今後、サードパーティのディレクトリに登録するには、別途承認が必要です。

最新の公開リリースは、Python 3.12以降向けにPyPIでfinos-mcp-core、finos-mcp-aigf、finos-mcp-cdm、finos-mcp-fdc3として、またx86およびARM向けのコンテナーイメージとして提供されています。

FINOSとは提携しておらず、FINOSからの推奨も受けていません。 これらは独立したコミュニティパッケージです。PyPIには、名前がfinos-で始まる公式のFINOSパッケージもありますが、ここに記載したものはそのいずれにも該当しません。

ライセンス

コードはApache-2.0ライセンスです。複製した標準仕様にはそれぞれ独自のライセンスが適用されます。AI Governance FrameworkはCC-BY-4.0ライセンス、CDMとFDC3はCommunity Specification License 1.0に基づいています。NOTICEをご覧ください。