mcp-mockuuups

Mockuuups Studio용 MCP 서버 — 약 5,300개의 기기 및 인쇄 목업을 검색한 다음 스크린샷이나 자신의 이미지를 렌더링할 수 있습니다.

하나의 디자인 — WTDIB 베를린 도시 가이드 — 단일 포토슛에서 네 개의 목업으로 렌더링되어, 기기가 바뀌어도 배경은 그대로 유지됩니다. 두 번의 도구 호출, 이미지 호스팅은 필요 없습니다.

왜 필요한가

Mockuuups는 자체 호스팅 MCP 서버를 https://mcp.mockuuups.studio/mcp 에서 제공합니다. 이 서버는 이미 알고 있는 목업 ID와 공개적으로 호스팅된 이미지가 필요한 단일 generate_mockup 도구를 노출합니다.

이 서버는 대신 기본 REST API를 래핑하여, 호스팅된 서버를 실용적으로 사용하기 어렵게 만든 두 가지 격차를 해소합니다:

• 검색할 수 있습니다. 업스트림 카탈로그 엔드포인트는 검색 매개변수를 전혀 허용하지 않습니다 — q, type, family, tag는 조용히 무시되고 모든 요청은 동일한 필터링되지 않은 페이지를 반환합니다. 전체 카탈로그를 한 번 가져와 로컬에서 검색하므로 "책상 위의 태블릿" 또는 "포스터"가 실제로 무언가를 찾습니다.

• 업로드할 수 있습니다. Mockuuups는 URL에서만 렌더링합니다. 이 서버에 원시 이미지 바이트를 전달하면 렌더러가 가져올 수 있도록 단기간 유효한 추측 불가능한 링크 아래에 스테이징하므로, 로컬 디자인에는 버킷, CDN, 호스팅이 필요 없습니다.

로컬에 보유한 이미지 렌더링

Mockuuups는 URL에서만 렌더링합니다. image_base64를 전달하면 이 서버가 바이트를 단기간 유효한 추측 불가능한 링크 아래에 스테이징하고, 렌더러가 가져오도록 한 후 만료시킵니다 — 버킷, CDN, 호스팅 계정이 필요 없습니다.

위의 iPad 렌더는 디스크에서 업로드되어 액자 A3 포스터로 렌더링된 것입니다.

Related MCP server: Store Screenshot Generator MCP

도구

하나의 디자인을 여러 기기에 렌더링

함께 촬영된 장면은 태그를 공유하므로, 여러 기기에서 일관된 모습을 얻는 방법은 하나를 검색한 다음 해당 태그로 필터링하는 것입니다:

search_mockups(query="ipad", tag="update-august-2024-meeting-room")
create_mockups(
    mockup_ids=["Zkn1GMTfiAFX5ZOn", "Zkn2DsTfiAFX5ZPD", "Zkn15MTfiAFX5ZO_"],
    screenshot_url="https://wtdib.cdit-works.de/",
)

구성

.env.example을 참조하세요. 중요한 두 가지:

• MOCKUUUPS_API_KEY — mockuuups.studio/developers에서 발급받은 개발자 키.

• PUBLIC_BASE_URL — 이 서버의 공개 오리진. 업로드에 필요합니다. Mockuuups의 렌더러가 스테이징된 이미지를 공개 인터넷을 통해 다시 가져오기 때문입니다. 스크린샷 및 이미지 URL 렌더링은 이 값 없이도 작동합니다.

알아두면 좋은 플랜 제한

API는 크레딧으로 청구됩니다: 렌더 1회 = 1크레딧, 웹사이트 스크린샷 +1, 고해상도 +1. 성공한 렌더링에만 요금이 부과됩니다.

다음 두 가지 동작은 모르면 문제가 될 수 있습니다:

• size를 생략하면 고해상도로 처리되며, 이를 지원하지 않는 플랜에서는 feature-not-available 오류로 실패합니다. 이 서버는 항상 size를 명시적으로 전송하며, MOCKUUUPS_MAX_SIZE(기본값 1000, Trial 상한)로 제한됩니다. 계정에 hires 기능이 있으면 이 값을 올리세요.

• cdn-temporary가 있는 플랜에서는 전달 링크가 약 24시간 후 만료됩니다. 보관할 가치가 있는 것은 모두 다운로드하세요. account_status가 이를 보고합니다.

개발

uv sync
uv run pytest
uv run mcp-mockuuups          # stdio
TRANSPORT=http uv run mcp-mockuuups   # streamable-http on /mcp

라이선스

MIT