Skip to main content

Designer Studio MCP Server - A Model Context Protocol server for mobile UI inspiration via Mobbin

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

studio_design_mcp-1.0.2.tar.gz (16.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

studio_design_mcp-1.0.2-py3-none-any.whl (16.9 MB view details)

Uploaded Python 3

File details

Details for the file studio_design_mcp-1.0.2.tar.gz.

File metadata

  • Download URL: studio_design_mcp-1.0.2.tar.gz
  • Upload date:
  • Size: 16.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for studio_design_mcp-1.0.2.tar.gz
Algorithm Hash digest
SHA256 79c6aa98096e6a2f1c0740d6adb823731d79d0f49a5eaf6027c78518febe1c44
MD5 2fbbf932bcfd24b62a2f2d96b93a5795
BLAKE2b-256 902b31297457bf135c4d57eeb2f6e2a4cd6a3a44e7eb2ad7b692117907cf3cbe

See more details on using hashes here.

File details

Details for the file studio_design_mcp-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for studio_design_mcp-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 04a37ef66a98a39f6d16be25191abe39c29d2db3b90c4fa6969c66036856d7af
MD5 c467e6b93654d6acabec8a1333775d94
BLAKE2b-256 460b0d26f59962ef7de2260fdee234f758e829fbf610c7f0729c0def262d6e66

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page