uxspot-mcp

uxspot MCP サーバー

AI アシスタントが呼び出せる UX リファレンス。さらに、描画もできるようになりました。

uxspot.io は、厳選された無料の UX リファレンスです。平易な英語の定義と「なぜ重要なのか」を添えた203語の用語集、AI x UX ツールディレクトリ、5つのインタラクティブなチェックリスト、78トピックからなる Learn UX カリキュラム、そして毎日遊べる UX 用語ゲーム Spot Check を提供しています。このリポジトリでは、そのすべてを Claude、Cursor、その他の MCP クライアントから呼び出し可能なツールとして提供する、リモートの Model Context Protocol サーバーについて説明します。

• エンドポイント： https://uxspot.io/mcp — リモート、Streamable HTTP、ステートレス
• ランディングページとライブデモ： uxspot.io/mcp-server
• 認証： 不要 — キー、アカウント、レート制限登録は必要ありません
• プライバシー： すべてのツールは、公開されている uxspot.io のコンテンツに対する読み取り専用です。サーバーがプロジェクト、ファイル、アカウントを参照することはありません。
• 関連プロジェクト： uxspot Figma plugin — 同じリファレンスを、Figma 内でデザインメンターとして利用できます。Figma Community で公開中。

インストール

Claude Code

claude mcp add --transport http uxspot https://uxspot.io/mcp

Claude Desktop — ［設定］→［コネクター］→［カスタムコネクターを追加］を選択し、URL に https://uxspot.io/mcp を指定します。

Cursor — ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "uxspot": { "url": "https://uxspot.io/mcp" }
  }
}

Gemini アプリ（Spark） — ［設定］→［接続済みアプリ］→［カスタムアプリを追加］を選び、URL として https://uxspot.io/mcp を貼り付けます（URL のみです。以下の JSON は Spark ではなく Antigravity の形式です）。［詳細設定］に認証情報の入力欄が表示された場合は、空欄のままにしてください。uxspot がキーを要求することはありません。

Gemini（Antigravity） — Gemini CLI に代わる IDE および CLI です。~/.gemini/config/mcp_config.json に追加してから、CLI で /mcp を実行して確認します。

{
  "mcpServers": {
    "uxspot": { "serverUrl": "https://uxspot.io/mcp" }
  }
}

Gemini Enterprise は、Gemini の利用手段のうち、唯一利用できないものです。管理者が登録した OAuth コネクターが必要ですが、uxspot は設計上、キーを必要としません。

Streamable HTTP トランスポートに対応するその他の MCP クライアントでは、https://uxspot.io/mcp を指定してください。

ツール

ツール	引数	戻り値
search_glossary	query	定義と参照元 URL を含む、該当する UX 用語
define_term	term	1つの用語の詳細：定義、重要な理由、参照番号、空間概念を示すターミナル図、参照元 URL
list_ux_tools	category?	厳選された AI x UX ツールディレクトリ。カテゴリで絞り込み可能
list_checklists	—	トピック数と項目数を含む5つのチェックリスト
get_checklist	slug	1つのチェックリストの詳細：すべてのトピックと項目
search_curriculum	query	HTML および Markdown の URL を含む、該当する Learn UX のトピック
get_curriculum	—	Learn UX のシラバス全体の概要
spot_check	—	Spot Check 用語ゲームの1ラウンド：用語、正しい場合も誤っている場合もある定義、答え、解説

すべての回答には uxspot.io の参照元 URL が記載されるため、あなた（およびアシスタント）が内容を確認できます。

回答例

define_term("60-30-10") は、次の内容をそのまま返します。

**60-30-10 rule**
A color-proportion guideline borrowed from interior design: roughly 60% of a
screen in a dominant, usually neutral color, 30% in a secondary color, and 10%
in an accent reserved for emphasis — enough color to guide the eye without
competing for it.

**Why it matters** — Screens that feel colorful but calm almost always follow
some version of this split. Inverting it — letting the accent become the
majority — is why loud interfaces feel loud: when everything asks for
attention with color, nothing gets it.

**The numbers**
- 60% — dominant, usually neutral
- 30% — secondary, supporting surfaces
- 10% — accent, reserved for emphasis and actions

┌────────────────────────────────────┐
│                                    │
│      60% — dominant, neutral       │
│                                    │
├─────────────────────────┬──────────┤
│    30% — secondary      │ 10%      │
│                         │ accent   │
└─────────────────────────┴──────────┘

Source: https://uxspot.io/glossary/60-30-10-rule

ターミナルの図解

37の空間概念――比率、位置、階層、流れ――を、手描きのボックスアートで説明します。Zパターンの視線の動き、誤った場所に格納されたページを含む情報アーキテクチャのツリー、感情が落ち込むジャーニーマップ、共感マップの4象限、暗くしたページに打ち抜かれたモーダルなどです。

このセットは意図的に対象を絞っています。見本を表現するのに色（コントラスト比、アイトラッキングのヒートマップ）、動き（スケルトン画面のシマー）、またはインタラクション（フィッツの法則のタイマー、ツァイガルニク効果のチェックリスト）が必要な用語は、劣化した模倣を用意するのではなく、uxspot.io のライブインタラクティブ例へ案内します。また、モノスペースでは原理的に表現できないものもあります。ターミナルでカーニング図を示すのは、その主題そのものを偽ることになります。すべてのグリフが定義上同じ幅だからです。

すべての図は src/lib/glossaryAscii.ts で手作業で作成されており、自動生成はしていません。ここにあるほかのものと同じく内容を確認できます。また、このファイルには、何を描き、何をライブデモへ案内するのか、その理由を含む判断の全容が記録されています。

試してみる

アシスタントに次のようなことを尋ねてみてください。

• 「Zパターンとは何ですか？図にしてください。」
• 「UXにおけるアフォーダンスとは何ですか？詳しく読める場所も教えてください。」
• 「UXリサーチ向けのAIツールを一覧表示してください」
• 「アクセシビリティのチェックリストを教えてください」
• 「カリキュラムからユーザビリティテストを検索してください」
• 「UXの用語クイズを出してください」（Spot Checkをラウンドごとに実行します）

仕組み

サーバーは、静的な uxspot.io サイトの前段に配置された単一の Cloudflare Pages Function です。各 POST は完全な JSON-RPC のやり取りです（セッションもデータベースも使用しない、ステートレスな Streamable HTTP）。ツールはライブサイトを支えるものと同じ構造化データを読み込むため、応答は常に公開内容と同期しています。ツールの説明はデータファイルから件数も自動計算するため、上記の数字がずれることはありません。

server/ のコードと src/lib/ の図解マップは、デプロイ済みの Function を読み取り専用で複製したものです。透明性を確保し、MCP ディレクトリに掲載するために公開しています。信頼できる情報源は uxspot メインサイトのリポジトリにあります。Function が読み込むデータファイル（glossary.json、tools.json、checklists.json、curriculum.ts）もそこにあるため、この複製は閲覧用であり、ビルド用ではありません。

ライセンス

このリポジトリのサーバーコードは MIT License の下で公開されています。ツールが提供する uxspot.io のコンテンツ（定義、チェックリスト、カリキュラム）の著作権は引き続き © Soufiane Chraibi に帰属し、サイトおよびこの API を通じた利用が許諾されています。大量再配布は許可されていません。