設計を約束するのではなく、証拠に関する問いから始める

有用なタンパク質ワークフローでは、範囲を限定した問いを立てます。特定の標的または結合領域を調べる根拠となる構造的証拠は何か、という問いです。提案する手順は、入力配列または識別子 → タンパク質の同定と注釈 → 関連構造 → 観察されたリガンド接触 → 候補評価計画です。

このガイドでは、情報源が説明する検索・トリアージ機能と、提案するオーケストレーションパターンを組み合わせています。テスト済みですぐに使える統合環境を説明するものではありません。科学データの整理や創薬初期段階の評価、特に、ある構造や部位をさらに調べる理由を説明する必要がある場合に活用できます。

成果物は、タンパク質に創薬可能性がある、あるいは候補物質が結合するという根拠のない主張ではなく、証拠パケットであるべきです。取得した事実、ソフトウェアによる解釈、提案する研究活動を分けてください。より広いアーキテクチャの背景については、化学 AI スタックガイドとMCP、Skills、エージェント、API ガイドを参照してください。

コンポーネントの選定については、化学分野のMCP、化学AIエージェント入門、AI創薬ワークフローも参照してください。

各段階に適したコンポーネントを選ぶ

これらのリソースは異なるレイヤーに属します。MCP サーバーはサードパーティのインターフェースまたは解析ツール、RCSB PDB Data API は上流のホスト型メタデータサービス、DrugAgent は論文で説明された研究フレームワークです。いずれも相互に置き換えられるものとして扱わないでください。

コンポーネント 情報源が説明する役割 利用場面 保持すべき境界
UniProt MCP (cyanheads) タンパク質検索、注釈、識別子マッピング、分類、プロテオーム、配列 同定情報を確認し、タンパク質資料をまとめる 検索はタンパク質の特性予測ではない
RCSB MCP (cnyambura) エントリーとポリマーのメタデータ、構造のダウンロード、カスタム Data API クエリ 特定した PDB エントリーを調べ、座標ファイルを取得する 生物種検索ツールが返すのはガイダンスであり、検索結果ではない
RCSB PDB Data API 構造とその構成要素に関する REST および GraphQL メタデータ エンティティ、鎖、アセンブリ、化学コンポーネントの関係を正確に取得する メタデータ要求はドッキングやシミュレーションを実行しない
PocketScout MCP 構造、生物活性、保存性、バリアント、文献の証拠を用いた既知部位のトリアージ 観察されたリガンド接触領域を評価する 現時点で計算によるポケット予測機能はない。プロジェクトメタデータでは Alpha とされている
DrugAgent (Liu et al.) ML ワークフローのプログラミングと評価における Planner–Instructor の協働 別個の下流モデリング研究を検討する これらの MCP サーバーとの統合を裏付ける証拠は提示されていない

範囲の狭い検索には明示的なツールを選び、資料の整理にはガイド付きプロンプトを利用してください。プロンプトはワークフローの指示を提供しますが、実行可能なツールや依存関係に代わるものではありません。

構造を解釈する前にタンパク質の同定情報を確認する

提出された識別子、学名での生物種名、利用可能であれば配列から始めます。対象が標準タンパク質、特定のアイソフォーム、または改変された実験用コンストラクトのいずれかを記録してください。

UniProt MCP は uniprot_search_proteins、uniprot_map_ids、uniprot_get_entry、uniprot_get_sequence を提供します。検索では、既定でレビュー済みのエントリーが対象になります。レビュー済みかどうか、注釈の出典、タンパク質の存在に関する情報、利用可能な PubMed/ECO の証拠を保持し、すべての注釈を同程度に確実な事実として扱わないでください。

遺伝子シンボルが入力された場合は、生物種フィルタリングまたは分類群に基づく曖昧性解消を利用します。標準配列と、必要に応じてアイソフォーム配列を取得し、提出配列との比較を提案します。提供されたツールの説明からは、任意の配列類似性検索が可能とは確認できません。配列のみの入力では、別途選んだ同定方法か、人による確認を経てからアクセッションに基づく検索を行う必要があります。

サーバーのドキュメントによれば、エントリーおよび配列の呼び出しではアイソフォーム接尾辞が削除されます。証拠パケットには元のアイソフォーム識別子を保持してください。ベースアクセッションを使うことで、生物学的な対象が暗黙に変更されてはなりません。複数のタンパク質が候補として残る場合や、配列の対応関係が解決していない場合は中断してください。

エンティティおよび鎖のレベルで構造を対応付ける

利用可能な UniProt の構造相互参照または PocketScout の関連構造検索を使い、候補となる構造識別子を特定します。次に、エントリーメタデータと関連するポリマーエンティティを調べます。RCSB MCP ツールの既定値がエンティティ 1 だからといって、それを選択しないでください。

RCSB の階層では、エントリー、化学的に固有のエンティティ、個々のエンティティインスタンスまたは鎖、生物学的アセンブリ、化学コンポーネントが区別されます。複製間で共有される配列情報はエンティティレベルに属し、インスタンス固有の構造注釈は鎖レベルに属します。Data API は label_asym_id をポリマーインスタンス識別子として使用するため、すべての表示上の鎖ラベルが同等だと想定せず、鎖の命名規則を記録してください。

各候補構造について、以下を記録するよう提案します。

  • エントリー ID、標的エンティティ ID、鎖インスタンス、アセンブリ ID。
  • 由来する生物種、ポリマー配列、参照配列への相互参照、選択したアイソフォームとの対応関係で未解決のもの。
  • 構造の分類：実験構造、計算モデル、または統合構造。
  • 該当する場合は実験方法と分解能、または関連するモデル品質および入力データセットの注釈。
  • 標的領域のカバレッジ、座標の有無、リガンド識別子。

Data API のドキュメントでは、一部の選択された計算モデルと統合構造が扱われていますが、古いサードパーティ製 RCSB MCP ラッパーにも同等の対応があることを意味しません。ラッパーの説明範囲では不十分な場合、上流のインターフェースを使用してください。

構造から観察されたリガンド接触へ

RCSB MCP は mmCIF を含む座標ファイルをダウンロードでき、ダウンロード状況とローカルパスを返します。PocketScout のドキュメントでは、共結晶化リガンド近傍の残基を特定し、部位を分類し、複数の構造での再出現に基づいて観察されたポケットを統合するため、gemmi を使った座標解析が説明されています。

この区別は重要です。化学コンポーネントのメタデータが分子を特定する一方、座標解析が空間的な接触証拠をもたらします。リガンドの記録だけでは接触マップにはなりません。同様に、接触マップは実測された結合親和性でも、機能調節の証拠でもありません。

PocketScout は、リガンドの生物活性履歴、文献、既知のバリアント、結合残基の保存性も取得します。詳細なドキュメントで説明されているのは、マウス、ラット、カニクイザルとの局所コンテキスト比較であり、完全な多重配列アラインメントではありません。生データは、各ツールの interpretation フィールドとは分けて保持してください。

評価を提案する際は、リガンドと接触する鎖が想定した標的に対応しているかを確認します。ポケット分類、サイズに基づく創薬可能性評価、再出現の順位付けは、実験的結論ではなくソフトウェアが生成したトリアージ証拠として扱ってください。適切なリガンド含有構造がない場合は、その制約を報告してください。接触残基を捏造したり、手法を明示的に変更しないまま予測された空洞で代用したりしないでください。

明示的なワークフローゲートで MCP ツールを連携する

提案するコントローラーは、検証済み識別子を各コンポーネント間で受け渡し、未解決の判断があれば停止できます。

同定ゲート → 構造対応ゲート → 座標・リガンドゲート → 部位証拠の評価 → 人が承認した下流タスク。

UniProt MCP のドキュメントには、ローカル STDIO、セルフホストの Streamable HTTP、公開ホスト型エンドポイントが記載されています。PocketScout のドキュメントには、ホスト型とローカルでの実行が記載されています。RCSB MCP のドキュメントには、スタンドアロン実行と Claude Desktop の設定が記載されています。これらはクライアント評価の出発点であり、現在のあらゆるホストやトランスポートの組み合わせが動作する証拠ではありません。

ローカルセットアップの前に、実際のランタイム要件の違いを確認してください。UniProt の README の前提条件では Bun v1.3.0 以上が必要ですが、パッケージメタデータでは Bun >=1.4.0 が必要です。低い方の要件に頼らず、選択したパッケージの要件を確認してください。提供された RCSB MCP のプロジェクトメタデータでは Python >=3.13、PocketScout では Python >=3.11 が必要です。同じ環境でインストールできると想定せず、それぞれ個別に評価してください。

まず、小規模な検索タスクを使ってツールの検出、入力検証、出力スキーマ、ファイルへのアクセスを確認することを提案します。ダウンロードされたローカルパスは、想定する解析プロセスからアクセスできなければなりません。Skill やプロンプトを読み込んでも、サーバーのランタイムや座標解析の依存関係は提供されません。化学 MCP 選定ガイドには、補足となる選定基準が記載されています。

提案例：結果を前提とせずに EGFR 構造を評価する

**提案する演習であり、実行済みと報告されたものではありません：**PocketScout の README で言及されている EGFR/PDB の組み合わせ 1M17 を使って、部位評価パケットをまとめます。標的名、想定する生物種 Homo sapiens、研究チームが使用する配列またはアイソフォームから始めます。

  1. **同定情報の入力：**生物種を指定して UniProt で標的を特定します。選択したアクセッション、標準配列と関連するアイソフォーム配列、注釈の出典を出力します。提出配列をレコードに対応付けられない場合は中断します。
  2. 構造情報の入力：1M17 のメタデータを取得し、ポリマーエンティティと鎖を調べます。標的と構造の対応表を出力します。関連領域とコンストラクトが問いに適していることを確認してから続行します。
  3. **部位情報の入力：**座標に基づく結合部位の証拠を要求します。取得したリガンドの同定情報と接触残基を出力し、鎖と残基番号の文脈を保持します。応答に接触情報がない場合は、記憶に頼って補わず、その欠落を記録します。
  4. **コンテキスト情報の入力：**検証済みのアクセッションと対応付けた残基を使い、リガンド履歴、保存性、バリアント、文献を取得します。観察された各領域を調査する、または保留する理由を、証拠に基づいて一覧にします。
  5. **判断の出力：**次の3つから1つを提案します。観察された部位を調査する、追加の構造的証拠を探す、または同定情報や部位の証拠が未解決のため標的を保留する。

ここでは、特定のリガンド、接触残基、保存性の結果、順位を前提としていません。有用な最終パケットには、生の応答、対応表、未解決の問い、明示的な検証計画が含まれます。

不完全な取得をワークフローの状態として扱う

UniProt のマッピングジョブは実行中ジョブのチケットを返すことがあります。その場合は再送信せず、そのジョブの状態確認を続けてください。完了したマッピング結果には、個別のページ継続情報が含まれる場合があります。検索カーソル、マッピングの継続情報、セクションの概要は相互に置き換えられません。

注釈レコードが大きすぎる場合は、指定されたセクションを要求します。バッチごとにアクセッション単位の成功と失敗を確認し、存在しないフィールドはそのまま欠損として保持してください。不完全な応答を、完全に見えるタンパク質概要にしてはなりません。

RCSB へのリクエストでは REST のステータスと GraphQL 応答エラーを確認してください。HTTP が成功しても、GraphQL クエリの成功が確定するわけではありません。GraphQL ではオブジェクト識別子の明示が必要です。アーカイブ全体の取得は Holdings から別途開始し、その後バッチ処理します。Data API は一般的に使われる注釈を扱いますが、mmCIF 辞書の全項目を網羅してはいません。

一時的な障害には上限を設けた再試行を提案し、その後、影響を受けた段階を未完了として記録します。「結果を取得できなかった」「リクエストが失敗した」「調査した情報源では証拠を利用できなかった」を区別してください。タイムスタンプ付きで再取得結果をキャッシュし、クエリパラメーターも保持してください。データセットの出典と処理履歴ガイドを参照してください。

科学的証拠を誇張せずに候補を評価する

提案する候補評価では、証拠の完全性、標的領域との対応、観察された部位の再出現、リガンド履歴、バリアントに関する懸念、保存性、相反する文献を比較します。普遍的な数値スコアを作り上げず、理由を明示してください。

DrugAgent 方式の別個の下流タスクには、整理済みデータセット、目的、制約、スターターファイル、評価器を渡すことができます。その論文では、性能または失敗の報告を用いた ML ワークフローの計画と実装が説明されています。この引き継ぎは提案上の統合であり、既存の UniProt/PDB/PocketScout 接続ではありません。提示された証拠では、DrugAgent の実用可能なインストール手順は確認されていません。また、論文では幻覚のリスクがあるため、パイプラインをそのままデプロイしないよう警告しています。

構造の信頼度は結合の証拠ではありません。観察された接触は選択性の証拠ではありません。保存性の確認は動物モデルの妥当性を検証するものではありません。候補を前進させる前に、専門家による確認と、適切な結合、機能、選択性の実験を提案してください。このワークフローでは実験的検証を行ったとは主張しません。

読者向けチェックリスト

  • 同定情報、生物種、アイソフォーム、提出配列を個別に記録している。
  • エントリー、エンティティ、鎖、アセンブリ、残基番号が明確である。
  • 実験構造、計算モデル、統合構造を区別している。
  • リガンドの同定情報と接触の証拠を、想定ではなく取得している。
  • 生の結果、ソフトウェアの解釈、研究上の提案を分けている。
  • ページネーション、一部の失敗、欠損フィールド、GraphQL エラーに対処している。
  • クライアント対応、ランタイム、依存関係、ファイルアクセスをローカルで評価している。
  • 候補の判断に未解決の証拠と実験上の次の段階を含めている。

関連するガイドも参照してください：化学AIアプリの科学API：PubChemとRCSB PDB入門。

情報源

UniProt MCP READMEとパッケージメタデータは、検索機能とランタイムに関する注意点の根拠です。RCSB MCP READMEとプロジェクトメタデータは、ラッパーについて説明しています。RCSB PDB Data API ドキュメントは、階層、インターフェース、エラー処理の根拠です。PocketScout READMEとプロジェクトメタデータは、既知部位の解析と Alpha ステータスについて説明しています。DrugAgent 論文は、下流のプログラミング上の役割と制約の根拠です。