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

기여

• 이 프로젝트나 스크립트에 대한 제안 사항이 있으면 언제든지 알려주십시오. 마음에 드셨다면 자유롭게 사용하셔도 좋습니다. (추신: 별표도 눌러주세요!! 😬 )

• 여러분의 기여를 환영합니다!

  프로젝트 포크

  작업 내용 컴파일

  Pull Request 요청

크레딧: Samuel Jayasingh

최종 수정일: 2026년 4월 16일