verify
Checks generated stubs by importing project modules in the target Python environment, removes stubs that cause new failures, and returns verified stub sets for safe application.
Instructions
スタブに差し替えた状態を、対象環境の python で実際に import して確かめます(任意実行)。
警告: run_entry=True と実行の記録(record=True)は対象のプログラムを実際に実行します。ファイルの書き込み・削除、通信、機器の操作などの副作用が
起きえます。AI エージェントは、利用者が明示的に求めた時だけ run_entry=True / record=True を指定してください。GUI や常駐型の
プログラムは終了しないので timeout で打ち切られます。既定(run_entry=False)は import だけで、別の子プロセスでグラフ上のモジュールを import します(各モジュールの直下のコードは動きますが、エントリーのスクリプトは動かしません。エントリーを import するローカルのモジュールは対象から外し、import の途中でエントリーのファイルを開く操作は止めます。Python の open を通る読み込みは、別名(短いパス名・拡張パス形式・UNC・ハードリンク)でも、ファイルの同一性で見分けて止めます。OS のコピー API(shutil.copy2 の CopyFile2 など)、ctypes、外部コマンド(cmd /c type 等)での読み込みと、それでコピーしたファイル経由の import(zipimport 等)は止められません)。run_entry=True のエントリーは、標準出力をファイルにつないだ普段の起動と同じ条件(主な違いは PYTHONPATH の先頭の起動用フォルダと環境変数 MCP_PYSTUB_BOOT の 2 つ。ほかの違いは docs/safety.md の表を参照: 標準入力は空、標準出力はファイル、import sitecustomize が成功する、元のパッケージのファイルがディスクに残る、など。子プロセスは監査イベントで分かる起動を親子の対応で確かめ、ctypes・COM / WMI 経由の起動は検出できません。MPLBACKEND などは付けないので、窓を開くエントリーは呼ぶ側の環境変数で指定してください)で動かします。timeout は子プロセス 1 回あたりで、打ち切った時と終わった後は孫を含むプロセスの木を止めます。結果の verified_sets(確かめた組)をそのまま適用してください。一部だけを適用するなら、その組で確かめ直してください。確認済み(実行)は、docs/safety.md の「普段の実行との違い」の表の範囲で、動かした入力について確かめた結果です。配布前に、ビルドした exe を普段のやり方で試してください。
静的解析(analyze)は候補を出すだけです。verify は生成したスタブを一時フォルダに置き、対象環境の python を子プロセスで起動して、import グラフ上の全モジュールを import します。site-packages は 書き換えません。スタブ無しの基準と比べて新たに失敗したものの原因のスタブを外し、検証を通った組を返します。
Args: entry_point: プロジェクトのエントリーポイント python_path: 対象環境の site-packages(空なら現在の環境) packages: 確かめるスタブ化パッケージ(省略時は analyze の stubbable) submodules: 確かめるサブモジュール("asammdf.gui=>PySide6" の形で対象の C 拡張も指定。省略時は analyze のヒント) nofollow: 除外して確かめるパッケージ(省略時は analyze の nofollow) run_entry: True ならエントリー本体も実行して出力を元と比べる(False では import だけを確かめる) timeout: 子プロセス 1 回あたりの制限時間(秒) entry_args: エントリーに渡す引数(sys.argv[1:]。既定は空) cwd: エントリーを実行する作業フォルダ(既定はエントリーのあるフォルダ) record: True かつ run_entry=True のとき、基準(スタブなし)のエントリー実行で実行の記録も取る(追加の実行はしない) trace_files: 利用者が python -m mcp_pystub.trace で作った記録ファイル(合算して各項目の観測の区分に使う)
Returns: passed: 検証を通った組 / rejected: 外した項目と失敗の原文 / unresolved: 原因を特定できなかった項目 (passed には入れない)/ entry_matched・entry_note: エントリーの出力の一致(確かめていない時はその旨)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entry_point": "<entry_point>"
},
"name": "verify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | ||
| record | No | ||
| timeout | No | ||
| nofollow | No | ||
| packages | No | ||
| run_entry | No | ||
| entry_args | No | ||
| submodules | No | ||
| entry_point | Yes | ||
| python_path | No | ||
| trace_files | No |