Skip to main content

Studio Design MCP

A Model Context Protocol (MCP) server for design inspiration - search UI patterns, designs, and references across multiple platforms.

Available Tools

Tool Description
🎨 search_mobbin_flows Search mobile app UI flows and screens from Mobbin's curated collection
🎨 search_mobbin_screens Get specific screens for apps and flows from Mobbin
🎯 search_dribbble_shots Search design shots and inspiration on Dribbble
📌 search_pinterest_images Search design references and visual inspiration on Pinterest

Features

  • Multi-Platform Search: Access design inspiration from Mobbin, Dribbble, and Pinterest
  • Mobile UI Patterns: Explore real-world mobile app screenshots and flows
  • Design References: Find visual inspiration for UI/UX projects
  • No Authentication Required: Works out of the box without credentials

Quick Start

See SETUP.md for detailed installation instructions.

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/gim-home/studio-8-design-agent.git
    cd studio-8-design-agent
    
  2. Install dependencies:

    uv sync
    uv run playwright install chromium
    
  3. Configure MCP in VS Code:

    Create .vscode/mcp.json in the project directory:

    {
      "servers": {
        "studio-design-mcp": {
          "type": "stdio",
          "command": "uv",
          "args": ["--directory", ".", "run", "-m", "studio_design_mcp"],
          "env": {}
        }
      }
    }
    
  4. Open in VS Code:

    code .
    
  5. Verify setup:

    • Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux)
    • Type: MCP: List Servers
    • Verify "studio-design-mcp" is running

Usage Examples

Once the MCP server is running, use these commands in GitHub Copilot Chat:

Mobbin - Mobile UI Flows

Search Mobbin flows for Instagram app
Get onboarding screens from Twitter app in Mobbin

Dribbble - Design Inspiration

Search Dribbble for "dashboard design"
Find "mobile app login" designs on Dribbble

Pinterest - Visual References

Search Pinterest for "modern UI design"
Find "minimalist website" examples on Pinterest

Development

Running Locally

uv run -m studio_design_mcp

Architecture

  • MCP Framework: Built on FastMCP for easy tool registration
  • Mobbin Search: Local catalog search for mobile app UI flows and screens
  • Dribbble Integration: Headless browser automation using Playwright
  • Pinterest Integration: Headless browser automation using Playwright

Recent Updates

  • ✅ Added Dribbble shot search integration
  • ✅ Added Pinterest image search integration
  • ✅ Mobbin local catalog with flows and screens data
  • ✅ Simplified setup - no authentication required

Contributing

This project is focused on design inspiration across multiple platforms. When adding new features, please ensure they align with this mission.

License

MIT License

Metadata

Release files for studio-design-mcp 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for studio-design-mcp 1.0.2
File Size Uploaded Provenance
studio_design_mcp-1.0.2.tar.gz 16.4 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for studio-design-mcp 1.0.2
File Interpreter ABI Platform
studio_design_mcp-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 33.3 MB

Release files / studio_design_mcp-1.0.2.tar.gz

Download URL studio_design_mcp-1.0.2.tar.gz
Size 16.4 MB
Tags Source
SHA-256 checksum
How to use checksums
79c6aa98096e6a2f1c0740d6adb823731d79d0f49a5eaf6027c78518febe1c44
BLAKE2b-256 checksum
How to use checksums
902b31297457bf135c4d57eeb2f6e2a4cd6a3a44e7eb2ad7b692117907cf3cbe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / studio_design_mcp-1.0.2-py3-none-any.whl

Download URL studio_design_mcp-1.0.2-py3-none-any.whl
Size 16.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
04a37ef66a98a39f6d16be25191abe39c29d2db3b90c4fa6969c66036856d7af
BLAKE2b-256 checksum
How to use checksums
460b0d26f59962ef7de2260fdee234f758e829fbf610c7f0729c0def262d6e66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for studio-design-mcp 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page