HumanCraft UI (Antigravity MCP)

Antigravity MCP 服务：HumanCraft UI (@aibuildinfra/humancraft)

这款顶尖的 Antigravity MCP 服务 专为 Google Antigravity（AGY）打造。HumanCraft 可消除网站布局和文案中的“AI 垃圾内容”，强制执行真实的 E-E-A-T 实体对齐，提取真实的客户端素材而非使用默认占位内容，并依据 Google 的信息增益原则构建抗搜索引擎算法变化的网站。

由 AI Build Infra 开发和维护——为人工智能提供高性能基础设施。

---

🔍 为什么需要这个 Antigravity MCP 服务

使用 Google Antigravity 搭建网站或撰写落地页文案时，缺乏约束的模型往往会套用泛泛的算法模板，导致内容受到搜索引擎惩罚：

1. AI 垃圾标题：泛泛的二级标题（“什么是 X？”、“主要优势”、“为什么选择我们”、“结论”）无法为 Google 排名模型带来任何信息增益（美国专利 2022/0277032 A1）。
2. 虚假的 E-E-A-T 和默认值：虚构的指标（“效率提升了 30%”）或捏造的人物（“Alex Miller 博士”）可能触发 Google Search Console 的人工处置，例如 “纯垃圾内容”和“规模化内容滥用”。
3. 二元勾选表格：充斥 Yes / No 勾选标记的低价值表格，无法说明权衡取舍或技术实际情况。
4. 视觉同质化：单调的紫色/青色渐变（#8b5cf6 -> #ec4899）、刻板的三列卡片布局，以及缺乏触感反馈的按钮。

HumanCraft 是专用的 Antigravity MCP，可系统性杜绝这些模式，并为 Antigravity 提供人性化设计启发式方法、令牌优化的检查工具，以及经过验证的 Schema.org 实体图谱。

---

💡 HumanCraft 在 Google Antigravity 中的工作方式

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              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

• 用途：提取真实从业者经验、项目图片（遥测截图、现场照片）、项目类别、基准第 0 天与经审计第 90 天的指标，以及反直觉的权衡取舍。
• 严格禁止默认填充规则：如果缺少必要字段，工具会返回 REQUIRES_USER_INPUT 并提示用户提供真实数据，而不是允许模型编造虚构的占位内容。

2. validate_heading_intent

• 用途：扫描标题，检查是否包含列入黑名单的 AI 陈词滥调，并评估用户意图。
• 空话与意图：
  • ❌ 空话：“什么是数据库分片？”
  • ✅ 意图：“单节点写入吞吐量降至 10k TPS 以下时：分片的临界点”
  • ❌ 空话：“自动化合规的主要优势”
  • ✅ 意图：“将 SOC 2 Type II 审计准备时间从 300 小时缩短至不足 40 小时”

3. build_comparison_matrix

• 用途：禁止使用二元对勾表（“是/否”）。生成包含多个实证参数的矩阵（单位经济效益、负载下的延迟、架构权衡以及验证方法）。
• 输出：易于访问的语义 HTML，并配有 Schema.org ItemList JSON-LD。

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 代码片段，并标记紫色渐变、三列卡片布局、缺少按钮挤压动效（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）、硬偏移阴影。

---

⚡ Token 优化与支出上限保护

从设计之初就旨在保护你的 Antigravity token 限额：

• 超精简工具签名：注入 Antigravity 系统提示词的 token 占用极少。
• 高密度结构化输出：返回简洁的 JSON 摘要和可执行标记，而非冗长的对话填充内容。
• 输入长度限制：施加严格限制（每个标题最多 300 个字符，每份 HTML 文档最多 100KB），避免上下文窗口被塞满。

---

🔒 安全与 ReDoS 加固

1. 防范 ReDoS：所有模式匹配器都在有界子字符串上运行，即使面对恶意负载，也能在 $< 5\text{ ms}$ 内终止。
2. 严格的 HTTPS 白名单：sameAs 实体链接仅允许使用 https:// URI（屏蔽 javascript:、data:、file:）。
3. XSS 防护：自动转义所有呈现表格和 schema 块中的 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 为我们的数据库产品设计一个落地页。先执行 Harvest intake，确保不会使用默认占位内容。”
   • “对我们的文档大纲运行 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 倾力打造 — 为人工智能构建高性能基础设施。