Mobbin MCP服务器
\[！警告\] 此存储库已存档，不再维护。 Mobbin已经发布了一个官方的MCP服务器——请使用它：https://mobbin.com/mcp 该项目是在官方MCP支持存在之前通过逆向工程Mobbin的内部端点构建的。既然Mobbin维护着第一方服务器，那么官方服务器是推荐的选择，并将与他们的平台保持同步。此回购仅供历史参考；将不接受进一步的更新、错误修复或PR。
连接到的非官方MCP服务器 莫宾 --设计灵感平台，拥有1100+个应用程序的600k+屏幕。搜索应用程序、浏览屏幕截图、探索用户流，并直接从Claude访问您保存的收藏。
Mobbin没有公共的API。此服务器是通过对其内部端点进行逆向工程而构建的。
工具
| 工具 | 说明 | 使用时 | |||
|---|---|---|---|---|---|
mobbin_search_apps | 按类别和平台搜索和浏览应用程序 | 您希望按平台或类别查找目录。更喜欢 mobbin_quick_search 当您已经知道应用程序名称并需要其应用程序ID时 | |||
mobbin_search_screens | 按UI模式、元素或文本内容搜索屏幕 | 您需要跨应用程序的全局屏幕灵感。使用 screen_patterns Mobbin分类概念和 screen_keywords 用于可见/OCR文本。使用 mobbin_get_app_screens 之后 mobbin_quick_search 对于一个命名的应用程序。 | |||
mobbin_search_flows | 按操作类型搜索用户流（例如，入职、结账） | 您希望按操作类型获得全球旅程灵感。更喜欢 mobbin_get_app_flows 之后 mobbin_quick_search 用于来自一个命名应用程序的流。 | |||
mobbin_quick_search | 按名称快速自动完成应用程序搜索 | 您有一个应用程序名称或可能的应用程序名称，需要它的应用程序ID。首选 mobbin_search_apps 用于平台/类别浏览。 | |||
mobbin_get_app_screens | 获取一个应用程序的每个屏幕（与配对 quick_search 深入特定应用程序） | 用户命名了一个特定应用程序，并希望看到该应用程序的屏幕。更喜欢 mobbin_search_screens 查看广泛的跨应用程序示例。 | |||
mobbin_get_app_flows | 获取一个应用程序的每个用户流量（与配对 quick_search 深入特定应用程序） | 用户命名特定应用程序并希望该应用程序的流程。更喜欢 mobbin_search_flows 适用于广泛的跨应用程序之旅。 | |||
mobbin_popular_apps | 按类别对热门应用进行分组 | 您需要一个按类别分组的热门度快照。更喜欢 mobbin_search_apps 随着 sort_by: "publishedAt" 用于分页最近的应用程序浏览或类别过滤器。 | |||
mobbin_list_collections | 列出您保存的收藏 | 您需要保存的收藏名称、ID和应用程序/屏幕/流量计数。这仅列出元数据；在以下时间之前无法提取收藏项目 mobbin_get_collection 土地。 | |||
mobbin_get_screen_detail | 获取特定屏幕的完整屏幕截图图像，并可选择主色提取 | 您已经拥有 screen_url 并且需要完整的图像、视觉检查、元数据或可选的主色提取。 | |||
mobbin_get_filters | 获取一个过滤器方面的有效值： `kind: "categories" \ | "patterns" \ | "elements" \ | "actions"` | 在填充之前，您需要有效的筛选值或定义 categories, screen_patterns, screen_elements，或 flow_actions 在搜索工具上。 |
深入特定应用
mobbin_search_screens 和 mobbin_search_flows 全球指数Mobbin——他们不接受 app_id 过滤器（上游API以静默方式忽略per-app过滤器）。对于“向我展示Notion的入职培训”风格的查询，请使用两步路径： mobbin_quick_search 查找应用程序的 id那么 mobbin_get_app_screens 或 mobbin_get_app_flows 说完这个 app_id详细信息工具从Mobbin的SSR应用程序详细信息页面读取，因此它们返回Mobbin为该应用程序提供的所有内容。
迁移： mobbin_get_filters
无参数表单已删除。一个响应中的完整分类超过了每个工具的MCP结果标记上限，并迫使代理从临时文件中读回结果。通过a kind 将响应范围限定在一个方面：
mobbin_get_filters({ kind: "patterns" }) // newline list of names
mobbin_get_filters({ kind: "patterns", include_definitions: true }) // bullets with descriptions
mobbin_get_filters({ kind: "patterns", include_counts: true }) // bullets with content counts设置
先决条件
- Node.js 18+
- A. 莫宾 帐户（免费或付费）
1.身份验证
选项A:CLI命令（推荐）
npx -y mobbin-mcp@latest auth这将引导您完成从浏览器复制会话cookie的过程：
- 打开 mobbin.com 并登录
- 打开浏览器控制台(
Cmd+Option+J) - 跑
copy(document.cookie)将您的Cookie复制到剪贴板 - 粘贴到CLI提示符中
您的会话已保存到 ~/.mobbin-mcp/auth.json 并自动刷新。
什么意思copy(document.cookie)是吗？ 它会将当前网站（mobbin.com）的浏览器Cookie复制到剪贴板。这包括您的Subabase会话令牌，MCP服务器需要代表您发出API请求。Cookie存储在您的本地计算机上~/.mobbin-mcp/auth.json并且从不发送到除Mobbin的API之外的任何地方。
选项B：环境变量（手动）
- 打开 mobbin.com 在Chrome浏览器中登录
- 打开DevTools(
Cmd+Option+I) → 应用 tab → 饼干 →https://mobbin.com - 查找名为的Cookie
sb-ujasntkfphywizsdaapi-auth-token.0和sb-ujasntkfphywizsdaapi-auth-token.1 - 复制 全额 每一块饼干
- 将它们组合成一个字符串：
sb-ujasntkfphywizsdaapi-auth-token.0=; sb-ujasntkfphywizsdaapi-auth-token.1=- 集
MOBBIN_AUTH_COOKIE到该值（见下面的步骤2）
2.添加到克劳德代码
claude mcp add mobbin -- npx -y mobbin-mcp如果使用CLI auth命令（选项A），则不需要额外的配置——服务器从 ~/.mobbin-mcp/auth.json 自动。
如果使用环境变量（选项B），请在添加时传递它：
claude mcp add mobbin -e MOBBIN_AUTH_COOKIE="sb-ujasntkfphywizsdaapi-auth-token.0=...; sb-ujasntkfphywizsdaapi-auth-token.1=..." -- npx -y mobbin-mcp替代方案：克劳德桌面
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mobbin": {
"command": "npx",
"args": ["-y", "mobbin-mcp"]
}
}
}示例提示
- “我正在为一款送餐应用程序设计结账流程——向我展示DoorDash和Uber Eats等顶级应用程序是如何处理的”
- “调出Duolingo入职流程，引导我了解每个屏幕的设计决策”
- “找到使用底部页面的登录屏幕并提取调色板——我需要灵感来重新设计我们的身份验证”
- “比较金融科技应用程序如何处理设置屏幕——向我展示Robinhood、Cash App和Venmo的示例”
- “在旅游应用程序中搜索基于卡片布局的屏幕，然后详细地向我展示最好的一个”
- “iOS上现在流行什么UI模式？显示顶部屏幕”
运作原理
Mobbin是由Supabase支持的Next.js应用程序。此服务器调用Mobbin的内部API路由(/api/content/search-apps, /api/content/search-screens等）使用您的会话cookie进行身份验证。代币通过Supabase自动刷新 /auth/v1/token 在它们过期之前终止，并持久化回 ~/.mobbin-mcp/auth.json 使用CLI身份验证方法时。
屏幕图像通过Mobbin的Bytescale CDN提供。这 mobbin_get_screen_detail 该工具自动将Supabase存储URL从搜索结果转换为CDN URL，获取图像，并将其作为base64内容返回，模型可以查看和分析。可选的颜色提取用途 锋利 从屏幕截图中返回主要的十六进制颜色。
项目结构
src/
index.ts # MCP server entry point, CLI routing, and tool registration
constants.ts # API URLs, keys, and config
types.ts # TypeScript interfaces for all Mobbin data models
cli/
auth.ts # Interactive CLI authentication flow
services/
auth.ts # Token parsing, expiry checks, and auto-refresh
api-client.ts # HTTP client for all Mobbin API endpoints
utils/
auth-store.ts # Persistent session storage (~/.mobbin-mcp/auth.json)
formatting.ts # Markdown formatters for tool responses许可证
国际学生委员会