aka-kika/hig-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCP サーバーは、AI コーディングエージェント向けの構造設計トークンとして、Apple Human Interface ガイドラインをサービングしました。ポスト WWDC25 システムカラー、液体ガラス制約、SwiftUI マッピング.
概要
— 実際のシステムカラー値、型ランプ、液体ガラス制約、およびSwiftUIマッピング — ではなく、偽物や固定ルの六角を幻覚します。 WWDC25 Appleは、液体ガラスを出荷しませんでした。それは静かに(HIG変更ログ、6月9、2025)。 SystemBlue は #007AFF ではありません。 #0088FFです。 - iOSの色をエージェントに依頼し、あらかじめ-2025パレットをハードコードします。 - Appleは、Webページとしてガイドラインを公開します。エージェントは、数千のトークンを1つ取得し、それでも数字を推測します。 - — 予算、レイヤーキャップの堆肥化、ブール後に測定されたコントラスト、必須の減少透明フォールバック。 エージェントは、デフォルトで、それらすべてに違反します。 生成された SwiftUI を調べて、盗みやすいように見え、どこにでもサブットリーオフspecです。 キュレーション、検証済みのトークンファイルは、オフライン、デテミニズリスティック、ニアゼロトークン - とプロスは、 sosumi.ai からライブ取得されるので、ガイダンスは決して失いません。 色を要求し、2023メモリではなく、現在のポストWDC25スペックテーブルを入手してください.
概要（AI 翻訳）
Claudeコード、Cursor、およびMCPクライアントに構造化されたデータとしてApple Human Interfaceのガイドラインを与えるMCPサーバー — 実際のシステムカラー値、型ランプ、液体ガラス制約、およびSwiftUIマッピング — ではなく、誤読や障害物を把握する。
すべてのApple dev (およびそのエージェント) の問題は、現在
WWDC25では、Appleは液体ガラスを出荷しませんでした — それは静かに**システムカラーパレット(HIG変更ログ、6月9、2025)を再構築しました。 [systemBlue]はもう#007AFFではありません。 #0088FFです。
つまり、
-LLMのトレーニングデータが間違っています。 iOSのカラーのエージェントに依頼し、あらかじめ-2025パレットをハードコードします。
- ハイグは、データではなく偽物です。 Appleは、Webページとしてガイドラインを公開します。エージェントは、数千のトークンを1つ取得し、まだ数字を推測します。
- 液体ガラスは、誰も1か所に書いていないルールを持っています - 予算、堆肥化層キャップ、コントラスト測定 afterブール、必須の減少透明度。 エージェントは、デフォルトで、それらすべてに違反します。
生成された SwiftUI を looks で確認し、どこにでもサブットリーオフspec です。
hig-mcpが解決する方法
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
hig-mcp — Apple HIG design tokens for AI coding agents
An MCP server that gives Claude Code, Cursor, and any MCP client the Apple Human Interface Guidelines as structured data — real system color values, the type ramp, Liquid Glass constraints, and SwiftUI mappings — instead of prose to misread or stale hex to hallucinate.
The problem every Apple dev (and their agent) has right now
At WWDC25 Apple didn’t just ship Liquid Glass — it quietly refreshed the system color palette (HIG changelog, June 9, 2025). systemBlue is not #007AFF anymore. It’s #0088FF.
Which means:
- Every LLM’s training data is wrong. Ask an agent for iOS colors and it confidently hardcodes the pre-2025 palette.
- The HIG is prose, not data. Apple publishes guidelines as web pages; an agent burns thousands of tokens fetching one, then still guesses the numbers.
- Liquid Glass has rules nobody wrote down in one place — blur budgets, compositing layer caps, contrast measured after blur, the mandatory Reduce Transparency fallback. Agents violate all of them by default.
You end up reviewing generated SwiftUI that looks plausible and is subtly off-spec everywhere.
How hig-mcp solves it
Curated, verified token files live inside the server — offline, deterministic, near-zero tokens — and prose is fetched live from sosumi.ai so guidance is never stale. Ask for color and you get the current post-WWDC25 spec table, not a 2023 memory.
| Tool | What it returns | Network |
|---|---|---|
hig_get_tokens |
Design tokens by category: color, typography, materials, layout, swiftui, sf_symbols | no |
hig_check_liquid_glass |
Liquid Glass guardrails + a concrete checklist for your context and platform | no |
hig_swiftui |
HIG component → the right SwiftUI API + which tokens to apply | no |
hig_fetch |
Current HIG page as clean Markdown (via sosumi.ai) | yes |
How it works
Four tools over stdio (Python, the official mcp SDK 2.x). The structured half is plain JSON you own and extend (src/hig_mcp/data/); the prose half is delegated to sosumi.ai’s DocC-to-Markdown rendering rather than rebuilt. Every value is provenance-tagged:
apple-system/apple-hig— Apple-published facts (system colors, type ramp, 44pt hit targets).wcag-aa— the 4.5:1 contrast rule.figma-effect/community-bestpractice— useful numbers Apple never published, flagged so you know to confirm.verify: true— beta-era API names that shift; confirm viahig_fetchor Xcode before shipping.
Each data file also carries a checked date in its _meta: the day its values were last compared with Apple’s live pages.
Honest data beats confident data.
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{ "mcpServers": { "hig": { "command": "hig-mcp" } } }