SDKサンプルを模倣するレビューでは現行仕様との契約差を別途照合する
MCP
レビュー
API契約
運用
原則
SDK の公式サンプルは実装パターンの正本にはなるが、プロトコル契約の最新版とは限らない。特に移行期は、サンプルが旧ホスト互換の MIME やメタデータ別名を使い続ける一方、現行リファレンスは標準キーや新しい MIME を必須条件としていることがある。サンプルへの忠実さだけを検証すると、ビルド・型検査・ローカルのリソース読取がすべて通っても、実ホストが UI ブリッジを有効化せずウィジェットが描画されない。
レビューでは、(1) サンプルから借りたキー・URI・MIME を列挙し、(2) 現行の公式リファレンスとトラブルシューティングで各値の標準・互換・非推奨を区別し、(3) 互換別名が明記された項目だけを互換経路として許容する。旧値の互換性が公式文書に明記されていない場合は、サンプルを根拠に承認せず実ホストで確認するか標準値へ寄せる。
検証は MCP の resources/list・resources/read が通ることだけでは足りない。実ホストでコンポーネントが描画され、ホストブリッジの通知受信と UI からの tools/call が動くことまで確認する。サンプルと現行仕様が食い違う場合は、現行仕様を契約の正本、サンプルを実装参考として扱う。