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
- macOS:
brew install uv(Install Homebrew first if needed) - Windows: Download uv and ensure it's in your PATH
Installation
-
Clone the repository:
git clone https://github.com/gim-home/studio-8-design-agent.git cd studio-8-design-agent
-
Install dependencies:
uv sync uv run playwright install chromium
-
Configure MCP in VS Code:
Create
.vscode/mcp.jsonin the project directory:{ "servers": { "studio-design-mcp": { "type": "stdio", "command": "uv", "args": ["--directory", ".", "run", "-m", "studio_design_mcp"], "env": {} } } }
-
Open in VS Code:
code . -
Verify setup:
- Press
Cmd+Shift+P(macOS) orCtrl+Shift+P(Windows/Linux) - Type: MCP: List Servers
- Verify "studio-design-mcp" is running
- Press
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
79c6aa98096e6a2f1c0740d6adb823731d79d0f49a5eaf6027c78518febe1c44
|
|
| MD5 |
2fbbf932bcfd24b62a2f2d96b93a5795
|
|
| BLAKE2b-256 |
902b31297457bf135c4d57eeb2f6e2a4cd6a3a44e7eb2ad7b692117907cf3cbe
|
File details
Details for the file studio_design_mcp-1.0.2-py3-none-any.whl.
File metadata
- Download URL: studio_design_mcp-1.0.2-py3-none-any.whl
- Upload date:
- Size: 16.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04a37ef66a98a39f6d16be25191abe39c29d2db3b90c4fa6969c66036856d7af
|
|
| MD5 |
c467e6b93654d6acabec8a1333775d94
|
|
| BLAKE2b-256 |
460b0d26f59962ef7de2260fdee234f758e829fbf610c7f0729c0def262d6e66
|