Mobbin MCP サーバー

Mobbin に接続する非公式の MCP サーバーです。Mobbin は、1,100 以上のアプリから 60 万枚以上のスクリーンを収録したデザインインスピレーションプラットフォームです。アプリの検索、スクリーンショットの閲覧、ユーザーフローの探索、保存済みコレクションへのアクセスを Claude から直接行えます。

Mobbin には公開 API がありません。このサーバーは、彼らの内部エンドポイントをリバースエンジニアリングして構築されました。

ツール

特定のアプリを深掘りする

mobbin_search_screens と mobbin_search_flows は Mobbin をグローバルにインデックス化しており、app_id フィルタを受け付けません（アップストリーム API はアプリごとのフィルタを黙って無視します）。「Notion のオンボーディングを見せて」といったクエリには、2 ステップのパスを使用してください：mobbin_quick_search でアプリの id を調べ、次にその app_id を指定して mobbin_get_app_screens または mobbin_get_app_flows を実行します。詳細ツールは Mobbin の SSR されたアプリ詳細ページから読み取るため、そのアプリに関して Mobbin が持っているすべての情報を返します。

移行: mobbin_get_filters

引数なしの形式は削除されました。1 回のレスポンスですべての分類を返すと MCP のツール結果ごとのトークン上限を超えてしまい、エージェントが一時ファイルから結果を読み直す必要があったためです。kind を渡して、レスポンスを 1 つのファセットに絞り込んでください：

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

Related MCP server: mobbin-forge

セットアップ

前提条件

• Node.js 18+

• Mobbin アカウント（無料または有料）

1. 認証

オプション A: CLI コマンド（推奨）

npx -y mobbin-mcp@latest auth

ブラウザからセッションクッキーをコピーする手順を案内します：

1. mobbin.com を開き、ログインする

2. ブラウザコンソールを開く (Cmd+Option+J)

3. copy(document.cookie) を実行してクッキーをクリップボードにコピーする

4. CLI プロンプトに貼り付ける

セッションは ~/.mobbin-mcp/auth.json に保存され、自動的に更新されます。

copy(document.cookie) とは何ですか？ 現在のサイト（mobbin.com）のブラウザクッキーをクリップボードにコピーします。これには、MCP サーバーがあなたに代わって API リクエストを行うために必要な Supabase セッショントークンが含まれます。クッキーはローカルマシン上の ~/.mobbin-mcp/auth.json に保存され、Mobbin の API 以外には送信されません。

オプション B: 環境変数（手動）

1. Chrome で mobbin.com を開き、ログインする

2. DevTools (Cmd+Option+I) → Application タブ → Cookies → https://mobbin.com を開く

3. sb-ujasntkfphywizsdaapi-auth-token.0 および sb-ujasntkfphywizsdaapi-auth-token.1 という名前のクッキーを見つける

4. 各クッキーの 完全な値 をコピーする

5. それらを 1 つの文字列に結合する：

sb-ujasntkfphywizsdaapi-auth-token.0=<value0>; sb-ujasntkfphywizsdaapi-auth-token.1=<value1>

6. MOBBIN_AUTH_COOKIE にその値を設定する（以下のステップ 2 を参照）

2. Claude Code に追加

claude mcp add mobbin -- npx -y mobbin-mcp

CLI 認証コマンド（オプション 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 Desktop

Claude Desktop の設定 (~/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 など) を呼び出します。トークンは期限切れになる前に Supabase の /auth/v1/token エンドポイント経由で自動的に更新され、CLI 認証メソッドを使用している場合は ~/.mobbin-mcp/auth.json に永続化されます。

スクリーン画像は Mobbin の Bytescale CDN を通じて提供されます。mobbin_get_screen_detail ツールは、検索結果の Supabase ストレージ URL を自動的に CDN URL に変換し、画像を取得して、モデルが確認・分析できる base64 コンテンツとして返します。オプションのカラー抽出では sharp を使用して、スクリーンショットから主要な 16 進数カラーを返します。

プロジェクト構造

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

ライセンス

ISC