Stitch-MCP

Google Stitchの機能をリモートのStitch MCPエンドポイントにリクエストを転送することで、ローカルツールとして公開するMCP（Model Context Protocol）サーバーです。

このサーバーの機能

このサーバーは以下のことを行います：

• mcp.server.fastmcp.FastMCP を使用してローカルMCPツールサーバー（stdio）を実行します

• ツール呼び出しを https://stitch.googleapis.com/mcp に転送します

• STITCH_API_KEY 環境変数を通じて提供されるStitch APIキーを必要とします

Related MCP server: stitch-pro-mcp

要件

• Python 3.11以上

• Stitch APIキー (STITCH_API_KEY)

インストール

仮想環境を作成して有効化し、パッケージをインストールします：

python -m venv .venv
source .venv/bin/activate
pip install -e .

設定

サーバーは、存在する場合、ローカルの .env ファイルから環境変数を読み込みます（python-dotenv を使用）。

.env ファイルを作成します：

STITCH_API_KEY=your_api_key_here

サーバーの実行

インストールされたスクリプト経由で実行できます：

stitch-mcp

または直接実行します：

python server.py

MCPクライアントで、stitch-mcp（または python server.py）を実行するstdioサーバーを登録し、そのプロセス環境で STITCH_API_KEY が利用可能であることを確認してください。

利用可能なツール

プロジェクト管理：

• list_projects(filter: Optional[str] = None)

• create_project(title: str)

• get_project(name: str)

画面管理：

• list_screens(projectId: str)

• get_screen(name: str, projectId: str, screenId: str)

AI生成：

• generate_screen_from_text(projectId: str, prompt: str, deviceType: str = "MOBILE", modelId: str = "GEMINI_3_FLASH")

• edit_screens(projectId: str, selectedScreenIds: list[str], prompt: str, deviceType: str = "DEVICE_TYPE_UNSPECIFIED", modelId: str = "GEMINI_3_FLASH")

• generate_variants(projectId: str, selectedScreenIds: list[str], prompt: str, variantCount: int = 3, creativeRange: str = "EXPLORE", aspects: Optional[list[str]] = None, deviceType: str = "DEVICE_TYPE_UNSPECIFIED", modelId: str = "GEMINI_3_FLASH")

デザインシステム：

• list_design_systems(projectId: Optional[str] = None)

• create_design_system(...)

• update_design_system(...)

• apply_design_system(projectId: str, assetId: str, screen_instance_ids: list[str], screen_source_names: list[str])

注意事項とトラブルシューティング

• STITCH_API_KEY environment variable not set と表示される場合は、.env ファイルまたは環境変数を確認し、MCPクライアントプロセスを再起動してください。

• 一部の生成操作には数分かかる場合があります。リクエストがタイムアウトした場合は、しばらく待ってから get_screen を呼び出してください（この場合、サーバーはタイムアウトメッセージを返します）。

開発

agent.py は、MCPクライアントなしでツールを手動で試すための小さなヘルパースクリプトです。プレースホルダーIDを更新して実行してください：

python agent.py

貢献

• このプロジェクトやスクリプトに関する提案があれば、お気軽にお知らせください。気に入っていただけたなら、ご自由にお使いください。（追伸：スターもお願いします！！ 😬 ）

• 皆様からの貢献を大歓迎します！

  プロジェクトをフォークする

  作業をコンパイルする

  プルリクエストを送る

クレジット: Samuel Jayasingh

最終編集日: 2026年4月16日