summaryrefslogtreecommitdiff
path: root/doc/mcp.md
AgeCommit message (Collapse)Author
2026-09-12streamable-httpトランスポート対応を追加tanaka takashi
MCP SDK 2.xのMCPServer.run(transport="streamable-http")を使い、stdioに 加えてStreamable HTTPトランスポートで起動できるようにする。SSEはMCP仕様で 非推奨のため選択肢から除外し、transport enumはstdioとstreamable-httpの 2種類のみとした。 transportの選択はTOML [server] tableで指定し、CLI引数は追加しない。 仕様の「CLI上書きを行わない」「TOML集約」原則に準拠する。[server]省略時は stdio(後方互換)、streamable-http時はhost=127.0.0.1 port=8000を既定値とする。 変更内容: - config.py: ServerConfig dataclass、VALID_TRANSPORTS定数、AppConfig.server フィールド、load_configの[server]読込・validation追加 - cli.py: main()でconfig.server.transportに応じたrun()引数分岐 - tests/conftest.py: app_config fixtureにserver=ServerConfig()追加 - tests/test_config.py: [server]の正常系・異常系・境界値テスト追加 (省略時stdio既定値、streamable-http読込、sse/http/ws/unknown拒否、 port境界値0/65536/-1/文字列、host空文字拒否) - doc/config.md: [server]セクション追記、設定項目一覧表更新 - config.example.toml: [server]コメント例追記 - doc/Specifications.md: スコープ表にMCPトランスポート行追加 - doc/Design.md: 責務表と起動フロー更新 - doc/mcp.md: 概要のtransport記載更新 - README.md: streamable-http起動例追記 - script/smoke_streamable_http.py: streamable-http経由の検証スクリプト追加 検証: - ruff format/check、pyright 0 errors、pytest 50 passed - 実GPU・実モデルでstreamable-http経由generate_imageの全ルート確認 (HTTP接続→MCP initialize→tools/list→tools/call→PNG生成・返却) - 生成結果: 335KB PNG、512x512、20 steps、CFG 7.0
2026-09-12docs: MCPツールとTOML設定の利用仕様を追加tanaka takashi
現行実装を利用者が正確に設定・呼び出せるよう、MCP公開スキーマとconfigファイルの詳細リファレンスを追加。 MCPツール仕様: - generate_image、generate_guided_image、inpaint_imageの用途と入力項目を整理 - MCP SDKが生成する3ツールのJSON Schemaを掲載 - positive/negative promptのvalidationとsize列挙値・解像度を明記 - PNG/JPEGのBase64およびdata URI入力形式、文字数・pixel数上限を記載 - Depth、OpenPose、OpenPose FullのControlNet対応関係を説明 - Inpaint maskの白黒規約と50%閾値を明記 - ImageContentによるPNG返却と埋め込みmetadataを説明 - 単一GPU直列実行、入力・設定・推論・CUDA OOM・保存エラーを整理 設定ファイル仕様: - model、LoRA、generation、ControlNet、outputの全設定キーを一覧化 - 各項目の型、必須条件、既定値、数値範囲、許可値を記載 - checkpoint、VAE、LoRA、ControlNetの固定ディレクトリ解決規則を説明 - 相対パスの基準とモデル項目で任意パスを禁止する制約を明記 - schedulerと画像サイズの対応、ControlNetごとの利用方法を整理 - annotator重みのローカルキャッシュおよびオフラインロード要件を記載 - 最小構成と全機能構成のTOML例を追加 - 起動時validation条件と未定義keyの扱いを明記