Gemini Web MCP
このリポジトリの Gemini Web MCP サーバーおよび低トークンスキルサーバーには、このスキルを使用してください。
最初に
- プライマリーサーバーのツールを選択する前に、
gemini_get_tool_manifestを優先して使用してください。このツールはGEMINI_TOOLS=coreやGEMINI_TOOLS=promptsの場合でも、常にsrc.serverによって公開されています。 - マニフェストの
current_enabled、groups、workflowsを確認してください。静的なマニフェストには現在のプロセスでロードされていないグループが含まれる可能性があるため、ツール数をハードコードしないでください。 - 低トークンサーバーでは、Gemini を初期化するアカウント呼び出しの前に、認証不要の
account(action="manifest")とaccount(action="capabilities")を優先してください。 - 読み取り専用の探索を最初に行ってください:
gemini_doctor、マニフェスト/機能、gemini_probe_web_features、メタデータのみの履歴検索、プロファイル診断、インベントリ/リストツール。 privacy=reads_private_chat_textおよびその他のプライベートテキストツールは、明示的なユーザー意図ツールとして扱ってください:gemini_read_chat、gemini_export_chat、gemini_search_chats(scan_turns=true)、およびチャットテキストを読み取るリサーチレポート作成アクション。- 破壊的ツールは明示的なユーザー意図が必要です:
gemini_delete_chat、gemini_cleanup_test_artifacts(dry_run=false)、gemini_delete_scheduled_action、gemini_reset_session、gemini_manage_gems(action="delete")、プロンプト削除。
ツールサーフェス
- プライマリー MCP サーバー:
src.server- エージェントが Gemini モデルを呼び出すだけでよい場合は、
GEMINI_TOOLS=modelまたはchatを使用します。 - エージェントがチャット履歴のリスト/スキャン/検索/読み取り/エクスポートのために
gemini_historyのみを必要とする場合は、GEMINI_TOOLS=historyを使用します。 - エージェントが
gemini_history、gemini_notebooks、および明示的なチャットからノートブックへの移動を必要とする場合は、GEMINI_TOOLS=history-organizeを使用します。 - エージェントが読み取り専用の Web サーフェスインベントリのために
gemini_account_inventoryのみを必要とする場合は、GEMINI_TOOLS=account-readを使用します。 - 明示的に承認されたスケジュールアクションの作成/削除ワークフローにのみ、
GEMINI_TOOLS=scheduled-adminを使用します。 - デフォルトの
GEMINI_TOOLS=coreは、チャット、メディア、ファイル、リサーチを含む幅広いコンテンツワークフローとして残ります。 GEMINI_TOOLS=allは完全なメンテナンス/検証サーフェスであり、一般的なエージェントのデフォルトとしては適していません。GEMINI_TOOLS=promptsは、ローカルプロンプト管理と常時オンのマニフェスト/Cookie ヘルパーを追加します。
- エージェントが Gemini モデルを呼び出すだけでよい場合は、
- 低トークンスキルサーバー:
src.skill_server- コンパクトなツールガイダンスには
account(action="manifest")を使用します。 - Cookie なしの静的な Web 機能マップには
account(action="capabilities")を使用します。 - コンパクトなアカウントサーフェスインベントリには
account(action="features|links|usage|library|notebooks|scheduled|modes")を使用します。 - チャット履歴には
history(action="list|search|read|export|delete")を使用します。 - マーカーによるテストチャットまたはスケジュールアクションを削除する前に、
cleanup(dry_run=true)を使用します。 - コンパクトなスケジュールアクションワークフローには
scheduled(action="list|get|create|delete")を使用します。 - Lyria 3 Pro ミュージックリクエストには
create(type="music", model="pro")またはプライマリーのgemini_generate_musicを使用します。 - ライブアカウントワークフローの前の低コストなローカル事前チェックには
doctor(validate_browser=false)を使用します。 - Chrome に複数のサインインプロファイルがある場合は、
cookie(action="profiles")の後にcookie(action="get", profile="...")を使用します。
- コンパクトなツールガイダンスには
チャット履歴ワークフロー
- 完全性が重要な場合は、メタデータソースを詳細にスキャンします:
gemini_history(action="scan", limit=..., offset=..., response_format="json")
- 最初にメタデータをリストまたは検索します:
gemini_history(action="list", limit=..., offset=..., response_format="json")gemini_history(action="search", query=..., scan_turns=false, response_format="json")
- ユーザーがコンテンツ検索を要求した場合にのみ、ターンテキストをスキャンします:
gemini_history(action="search", query=..., scan_turns=true, turns_per_chat=..., max_chars_per_turn=...)
- ユーザーがターゲットを示した後にのみ、選択した1つのチャットを読み取り/エクスポートします:
gemini_history(action="read", chat_id=...)gemini_history(action="export", chat_id=..., response_format="markdown"|"json")
- ターゲットのチャットとノートブックの両方を特定した後にのみ、チャットをネイティブノートブックに移動します:
gemini_notebooks(action="list", ...)gemini_move_chat_to_notebook(chat_id=..., notebook_id=...)gemini_notebooks(action="chats", notebook_id=...)
- 明示的な確認がある場合にのみ削除します:
gemini_delete_chat(chat_id=...)
Web Pro カバレッジルール
gemini_get_web_capabilitiesは静的な観測された Pro Web サーフェスマップです。gemini_probe_web_featuresは観測された読み取り専用の RPC 到達可能性をチェックし、生のプライベート RPC ボディを公開してはなりません。- 読み取り専用のアカウントインベントリ(公開リンク、使用制限、ネイティブノートブック、ライブラリ機能、スケジュールアクション、ツールモードステータス)には
gemini_account_inventory(surface=...)またはマニフェストのweb_surface_inventoryワークフローを使用します。 gemini_list_library_capabilitiesは、プライベートライブラリアセットのエクスポートではなく、ローカライズされたテンプレート/機能発見として扱います。gemini_get_tool_mode_statusは読み取り専用の Canvas/Guided Learning モードステータスプローブとして扱います。Canvas ドキュメントの変更は無効のままです。- Guided Learning はチャットの
learning_modeを通じて公開されます。UI の前提よりこれを優先します。 - Drive ピッカー、Canvas 変更、設定変更、メモリインポート変更、公開リンク変更、およびサポートされていないスケジュールアクションの繰り返し/編集/切り替えバリアントは、安定した RPC 契約と明示的なユーザー承認が存在するまで無効のままにします。
メディアワークフロー
- 音楽/ビデオ/画像生成リクエストには MCP ツールパスを使用し、ツールが保存されたローカルメディアファイルまたは明示的なエクスポート失敗を報告した場合にのみ完了します。
- Lyria 3 Pro/フルソングの主張については、生のバックエンドマーカーと保存されたメディア期間を検証します。ラッパーラベル、モデル名、またはチャットの散文だけを信頼しないでください。
gemini_generate_musicは、response.mediaが空の場合でも、生のチャットペイロードからメディアを回復できます。成功を要約する前に、返されたファイルパスと期間メタデータを検査します。
スケジュールアクション
gemini_create_scheduled_action、gemini_list_scheduled_actions、gemini_get_scheduled_action、gemini_delete_scheduled_actionを通じて、観測された毎日の作成、レジストリリスト、ID による取得、ID による明示的な削除を使用します。- アカウントコンテキストが重要な場合は、最初に Chrome Cookie を更新します。レジストリが予期せず空の場合は、
gemini_list_browser_cookie_profilesを呼び出し、次に Gemini Cookie またはスケジュールレジストリエントリを持つプロファイルに対してgemini_get_cookie_from_browser(profile="...")を呼び出します。 - 作成/削除後は
verification_statusを確認します。作成後はreadable_by_id_after_createも確認し、削除後はdeleted_by_id_after_deleteまたはtask_state_after_delete=deletedを確認してから、タスクが存在しないと主張します。
検証
変更を完了する前に、以下を実行してください:
./.venv/bin/pytest -q
./.venv/bin/python -m py_compile src/tools/annotations.py src/tools/chat.py src/tools/media.py src/tools/file.py src/tools/research.py src/tools/prompts.py src/tools/manage.py src/server.py src/skill_server.py src/client_wrapper.py src/thinking_client.py src/constants.py
git diff --check
マニフェストまたは機能メタデータを変更する場合は、以下も検証してください:
GEMINI_TOOLS=core ./.venv/bin/python - <<'PY'
import asyncio
from src.server import mcp
async def main():
tools = await mcp.list_tools()
print(len(tools), [t.name for t in tools if t.annotations is None])
asyncio.run(main())
PY
スキルのみの変更の場合は、少なくともローカルプロジェクトコピーと公開リポジトリのスキルコピーの両方に対してスキルバリデータを実行してください:
for path in .codex/skills/gemini-web-mcp .agents/skills/gemini-web-mcp; do
./.venv/bin/python /Users/jack/.codex/skills/.system/skill-creator/scripts/quick_validate.py "$path"
done
evaluations/gemini_web_mcp_contract.xml を gemini_get_tool_manifest および gemini_get_web_capabilities と整合させてください。