HumanCraft UI (Antigravity MCP)

Antigravity MCP サーバー：HumanCraft UI (@aibuildinfra/humancraft)

Google Antigravity（AGY）専用に設計された、最先端のAntigravity MCP サーバーです。HumanCraftは、ウェブサイトのレイアウトやコピーにおける「AI スロップ」を排除し、真正なE-E-A-T エンティティの整合性を徹底します。また、デフォルトのプレースホルダーを使わずにクライアントの実証資産を抽出し、Google の Information Gain の原則に基づいた、検索エンジンに強いウェブサイトを構築します。

AI Build Infra が開発・メンテナンスしています。人工知能のための高性能インフラストラクチャです。

---

🔍 この Antigravity MCP サーバーが必要な理由

Google Antigravityでウェブサイトのひな形を作成したり、ランディングページのコピーを書いたりする際、制約のないモデルは、検索エンジンからペナルティを受ける一般的なアルゴリズム生成のテンプレートに陥りがちです。

1. AI スロップな見出し：Google のランキングモデル（米国特許 2022/0277032 A1）において Information Gain がまったくない、一般的な H2 見出し（「X とは？」、「主なメリット」、「当社を選ぶ理由」、「結論」）。
2. 偽の E-E-A-T とデフォルト値：捏造された数値（「効率が 30％向上」）や架空の人物（「Dr. Alex Miller」）は、Google Search Console の**「純粋なスパム」や「スケールされたコンテンツの不正使用」**に対する手動による対策を引き起こします。
3. 二択のチェックマーク表：トレードオフや技術的な実情を伝えられない、Yes / No のチェックマークで埋められた価値の低い表。
4. 視覚的な均質化：単調な紫／シアンのグラデーション（#8b5cf6 -> #ec4899）、画一的な 3 カードの横並び、触覚的なフィードバックのないボタン。

HumanCraftは専用のAntigravity MCPであり、こうしたパターンを体系的に禁止し、人間らしいデザインのヒューリスティック、トークン最適化されたリンター、検証済みの Schema.org エンティティグラフを Antigravity に提供します。

---

💡 Google Antigravity 内での HumanCraft の仕組み

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              Google Antigravity Assistant                              │
└───────────────────────────────────────────┬────────────────────────────────────────────┘
                                            │ Antigravity MCP Tool Calls
                                            ▼
┌────────────────────────────────────────────────────────────────────────────────────────┐
│                       HumanCraft Antigravity MCP Server                                │
├───────────────────────────────┬────────────────────────────────────────────────────────┤
│ 📋 harvest_client_intake       │ 4-tier intake questionnaire extracting real experience,│
│                               │ metrics, & assets; strictly bans default placeholders   │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 🎯 validate_heading_intent    │ Lints against generic AI headings ("What is X?");     │
│                               │ scores and enforces outcome/intent-driven H1-H3s       │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 📊 build_comparison_matrix    │ Generates high-information-gain comparison tables with │
│                               │ concrete unit metrics, trade-offs & semantic schema    │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 🛡️ audit_eeat_entity_graph    │ Verifies author/org Schema.org JSON-LD, validates     │
│                               │ sameAs URIs & connects publisher to aibuildinfra.com   │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 🎨 get_human_archetype        │ Curates style archetypes (Editorial, Dark Craft,       │
│                               │ Neo-Brutalist, Swiss) with tinted neutrals & type      │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 🔍 lint_design_anti_patterns  │ Scans HTML/Tailwind for AI tropes (purple gradients,   │
│                               │ 3-card monotony, dead buttons, buzzwords, ✨ emojis)   │
└───────────────────────────────┴────────────────────────────────────────────────────────┘

---

🛠️ Antigravity MCP ツール一覧

1. harvest_client_intake

• 目的：実際の実務経験、プロジェクト画像（テレメトリーのスクリーンショット、現場写真）、プロジェクトのカテゴリー、Day 0 のベースラインと監査済み Day 90 の指標、通説に反するトレードオフを抽出します。
• 厳格なデフォルト値禁止ルール：必須フィールドが不足している場合、ツールは REQUIRES_USER_INPUT を返し、モデルに架空のプレースホルダーを生成させるのではなく、実際のデータをユーザーに求めます。

2. validate_heading_intent

• 目的：見出しを禁止対象の AI 表現と照合し、ユーザーの意図をスコアリングします。
• 中身のない表現と意図のある表現：
  • ❌ 中身のない表現："データベースシャーディングとは？"
  • ✅ 意図のある表現："単一ノードの書き込みスループットが 10k TPS を下回るとき：シャーディングの転換点"
  • ❌ 中身のない表現："コンプライアンス自動化の主なメリット"
  • ✅ 意図のある表現："SOC 2 Type II 監査の準備を 300 時間から 40 時間未満に短縮"

3. build_comparison_matrix

• 目的：二択のチェックマーク表（Yes/No）を禁止し、実証的な多パラメーターのマトリックス（ユニットエコノミクス、負荷時のレイテンシ、アーキテクチャ上のトレードオフ、検証方法）を生成します。
• 出力：Schema.org ItemList JSON-LD を組み合わせた、アクセシブルなセマンティック HTML。

4. audit_eeat_entity_graph

• 目的：Schema.org JSON-LD を Google のナレッジグラフ標準と照合します。
• チェック項目：sameAs のエンティティリンクが信頼できる外部プラットフォーム（Wikidata、ORCID、Google Scholar、GitHub、LinkedIn）を参照していることを検証し、内容の乏しいホームページ URL を却下して、パブリッシャーの権威性を AI Build Infra に結び付けます。

5. lint_design_anti_patterns

• 目的：HTML/Tailwind のスニペットをスキャンし、紫のグラデーション、3 枚カードの横並び、ボタンの押し込み表現（active:scale-[0.98]）の欠落、AI の流行語（"supercharge"、"seamless"、✨ の絵文字）を検出します。

6. get_human_archetype

• 目的：厳選されたデザインシステムを返します。
  • エディトリアルテック：セリフ体（Newsreader）、控えめな細線の境界線、メタデータのアクセントに等幅フォント。
  • タクタイルダーククラフト：多層サーフェス（surface-0、surface-1）、半透明の 1px 境界線（border-white/10）。
  • 温かみのあるヒューマニスト：クリーム／リネンのキャンバス（#FBF9F5）、インク色のタイポグラフィ（#1C1917）、テラコッタのアクセント。
  • ネオ・ブルータリスト：コントラストの強い黒い輪郭線（border-2 border-black）、硬いオフセットシャドウ。

---

⚡ トークンの最適化と利用上限の維持

Antigravity のトークン上限を維持できるよう、ゼロから設計されています。

• 超コンパクトなツールシグネチャ：Antigravity のシステムプロンプトに挿入されるトークンの使用量を最小限に抑えます。
• 密度の高い構造化出力：冗長な会話の埋め草ではなく、簡潔な JSON の要約と実行可能なフラグを返します。
• 入力長の上限：コンテキストウィンドウの過剰な消費を防ぐため、厳格な上限（見出しあたり最大 300 文字、HTML ドキュメントあたり最大 100KB）を設けています。

---

🔒 セキュリティと ReDoS 対策の強化

1. ReDoS 耐性：すべてのパターンマッチャーは長さを制限した部分文字列を対象とし、悪意のあるペイロードに対しても $< 5\text{ ms}$ 以内に処理を終了します。
2. 厳格な HTTPS 許可リスト：sameAs エンティティリンクでは https:// URI のみを許可します（javascript:、data:、file: はブロックします）。
3. XSS 防御：レンダリングされるすべての表とスキーマブロックで、HTML エンティティを自動エスケープします。
4. 正式なポリシー：脆弱性の報告ガイドラインについては SECURITY.md を確認してください。

---

🚀 Google Antigravity にこの MCP をインストールする方法（ステップごとの手順）

ステップ 1：ローカルにクローンしてビルドする

git clone https://github.com/AI-BuildInfra/Humancraft-UI.git
cd Humancraft-UI
npm install
npm run build

---

ステップ 2：Antigravity の mcp_config.json に追加する

グローバルな Antigravity MCP 設定ファイルを開くか、新規作成してください。

• Windows：%USERPROFILE%\.gemini\config\mcp_config.json
  (例：C:\Users\<YourUsername>\.gemini\config\mcp_config.json)
• macOS / Linux：~/.gemini/config/mcp_config.json

humancraft サーバーの定義を追加してください。

{
  "mcpServers": {
    "humancraft": {
      "command": "node",
      "args": [
        "C:/path/to/Humancraft-UI/dist/index.js"
      ]
    }
  }
}

(C:/path/to/Humancraft-UI を、クローンしたディレクトリの絶対パスに置き換えてください。スラッシュ / を使用します。)

---

ステップ 3：Antigravity で検証して使用する

1. Antigravity を再読み込みする：新しいチャットセッションを開始します。
2. 検出を確認する：Antigravity で Additional Options (...) > MCP Servers をクリックし、humancraft が接続されていることを確認します。
3. Antigravity のプロンプト例：
   • 「HumanCraft MCP を使って、データベース製品のランディングページを設計してください。デフォルトのプレースホルダーを使わないよう、まず入力情報を収集してください。」
   • 「ドキュメントのアウトラインに対して validate_heading_intent を実行してください。」
   • 「build_comparison_matrix を使って、Redis と KeyDB の実証的な比較表を作成してください。」

---

❓ よくある質問（FAQ）

Antigravity MCP サーバーとは何ですか？

Antigravity MCP サーバーは、オープンな Model Context Protocol (MCP) を介して、Google Antigravity を専門的なツール、API、ワークフローに接続します。これにより、Antigravity は生成中にカスタムリンター、スキーマビルダー、設計ヒューリスティクスを直接実行できます。

HumanCraft はウェブサイトのランキングをどのように向上させますか？

HumanCraft は、Google の Information Gain 基準（米国特許 2022/0277032 A1）と E-E-A-T エンティティの照合を徹底します。一般的な AI 生成の低品質な見出しを成果重視の見出しに置き換え、実証的なパラメーター比較表を作成することで、Google の SpamBrain によるアルゴリズム上の順位低下を回避します。

この MCP はトークン使用量を増やしますか？

いいえ。HumanCraft は極めてコンパクトなツール定義を使用し、情報密度の高い構造化 JSON 差分を返すため、Antigravity のトークン使用量はベースラインと同じです。

---

🧪 自動テスト

6 つすべてのツールとセキュリティガードレールを対象に、自動テストスイートを実行します：

npm test

✔ build_comparison_matrix Tests (2/2 passed)
✔ lint_design_anti_patterns Tests (2/2 passed)
✔ audit_eeat_entity_graph Tests (2/2 passed)
✔ validate_heading_intent Tests (2/2 passed)
✔ harvest_client_intake Tests (2/2 passed)
✔ get_human_archetype Tests (2/2 passed)
✔ Security & Hardening Tests (4/4 passed)

Total: 16 passed | 0 failed | Time: ~800ms

---

📄 ライセンスとプライバシーポリシー

MIT License の下で配布されています。詳細は LICENSE をご覧ください。
厳格なゼロデータ収集プライバシーポリシーについては、PRIVACY.md をご覧ください。

AI Build Infra が誇りを持って開発しました — 人工知能のための高性能インフラを構築しています。