# Antigravity MCP Server: HumanCraft UI (`@aibuildinfra/humancraft`)

<p align="center">
  <a href="https://aibuildinfra.com/"><img src="https://img.shields.io/badge/Antigravity-MCP%20Compatible-7C3AED.svg?style=for-the-badge&logo=google" alt="Antigravity MCP Compatible"></a>
  <a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/Protocol-MCP%20v1.6-2563EB.svg?style=for-the-badge" alt="Model Context Protocol"></a>
  <a href="https://aibuildinfra.com/"><img src="https://img.shields.io/badge/Maintained%20By-AI%20Build%20Infra-blue.svg?style=for-the-badge" alt="Maintained by AI Build Infra"></a>
  <a href="https://github.com/Shree-varshan-430/Humancraft-UI/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge" alt="MIT License"></a>
  <a href="https://aibuildinfra.com/"><img src="https://img.shields.io/badge/Authority-E--E--A--T%20Verified-orange.svg?style=for-the-badge" alt="E-E-A-T Verified"></a>
</p>

The premier **Antigravity MCP Server** designed exclusively for **Google Antigravity** (AGY). **HumanCraft** eliminates "AI Slop" in website layouts and copy, enforces authentic **E-E-A-T entity reconciliation**, extracts empirical client assets without default placeholders, and builds search-engine-resilient websites powered by **Google's Information Gain** principles.

Developed and maintained by **[AI Build Infra](https://aibuildinfra.com/)** — High-Performance Infrastructure for Artificial Intelligence.

---

## 🔍 Why You Need This Antigravity MCP Server

When using **Google Antigravity** to scaffold websites or write landing page copy, unconstrained models often fall into generic algorithmic templates that get penalized by search engines:

1. **AI Slop Headings**: Generic H2s (*"What is X?"*, *"Key Benefits"*, *"Why Choose Us"*, *"Conclusion"*) that offer zero Information Gain under Google's ranking models (US Patent 2022/0277032 A1).
2. **Fake E-E-A-T & Defaults**: Hallucinated metrics (*"increased efficiency by 30%"*) or fictitious personas (*"Dr. Alex Miller"*) that trigger Google Search Console **"Pure Spam"** and **"Scaled Content Abuse"** manual actions.
3. **Binary Checkmark Tables**: Low-value tables filled with `Yes / No` checkmarks that fail to communicate trade-offs or technical realities.
4. **Visual Homogeneity**: Monotonous purple/cyan gradients (`#8b5cf6 -> #ec4899`), rigid 3-card rows, and buttons without tactile feedback.

**HumanCraft** is the dedicated **Antigravity MCP** that systematically outlaws these patterns and equips Antigravity with human design heuristics, token-optimized linters, and verified Schema.org entity graphs.

---

## 💡 How HumanCraft Works Inside 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 Tool Catalog

### 1. `harvest_client_intake`
* **Purpose**: Extracts real practitioner experience, project images (telemetry screenshots, on-site photos), project category, baseline Day 0 vs audited Day 90 metrics, and contrarian trade-offs.
* **Strict Anti-Defaulting Rule**: If essential fields are missing, the tool returns `REQUIRES_USER_INPUT` and prompts the user for real data instead of allowing the model to hallucinate synthetic placeholders.

### 2. `validate_heading_intent`
* **Purpose**: Scans headings against blacklisted AI tropes and scores user intent.
* **Slop vs Intent**:
  * ❌ *Slop*: *"What is Database Sharding?"*
  * ✅ *Intent*: **"When Single-Node Write Throughput Drops Below 10k TPS: The Sharding Tipping Point"**
  * ❌ *Slop*: *"Key Benefits of Automated Compliance"*
  * ✅ *Intent*: **"Cutting SOC 2 Type II Audit Preparation from 300 Hours to Under 40"**

### 3. `build_comparison_matrix`
* **Purpose**: Outlaws binary checkmark tables (`Yes/No`). Generates empirical multi-parameter matrices (unit economics, latency under load, architectural trade-offs, and verification methodologies).
* **Output**: Accessible semantic HTML paired with Schema.org `ItemList` JSON-LD.

### 4. `audit_eeat_entity_graph`
* **Purpose**: Reconciles Schema.org JSON-LD with Google's Knowledge Graph standards.
* **Checks**: Verifies `sameAs` entity links to authoritative external platforms (Wikidata, ORCID, Google Scholar, GitHub, LinkedIn), rejects shallow homepage URLs, and links publisher authority to **[AI Build Infra](https://aibuildinfra.com/)**.

### 5. `lint_design_anti_patterns`
* **Purpose**: Scans HTML/Tailwind snippets and flags purple gradients, 3-card rows, missing button squeeze physics (`active:scale-[0.98]`), and AI buzzwords (*"supercharge"*, *"seamless"*, ✨ emojis).

### 6. `get_human_archetype`
* **Purpose**: Returns curated design systems:
  * **Editorial Tech**: Serifs (*Newsreader*), subtle hairline borders, monospace metadata accents.
  * **Tactile Dark Craft**: Multi-layered surfaces (`surface-0`, `surface-1`), 1px translucent borders (`border-white/10`).
  * **Warm Humanist**: Cream/linen canvas (`#FBF9F5`), ink typography (`#1C1917`), terracotta accents.
  * **Neo-Brutalist**: High-contrast black outlines (`border-2 border-black`), hard offset shadows.

---

## ⚡ Token Optimization & Spend Limit Preservation

Designed from the ground up to **preserve your Antigravity token limits**:
* **Ultra-Compact Tool Signatures**: Minimal token footprint injected into Antigravity's system prompt.
* **Dense Structured Outputs**: Returns concise JSON summaries and actionable flags rather than verbose conversational filler.
* **Input Length Bounds**: Imposes strict limits (max 300 chars per heading, max 100KB per HTML document) to avoid context window flooding.

---

## 🔒 Security & ReDoS Hardening

1. **ReDoS Immunity**: All pattern matchers operate on bounded substrings, terminating in $< 5\text{ ms}$ even under adversarial payloads.
2. **Strict HTTPS Whitelist**: Permits only `https://` URIs for `sameAs` entity links (blocks `javascript:`, `data:`, `file:`).
3. **XSS Defense**: Automatic HTML entity escaping across all rendered tables and schema blocks.
4. **Formal Policy**: Review [`SECURITY.md`](./SECURITY.md) for vulnerability reporting guidelines.

---

## 🚀 How to Install This MCP in Google Antigravity (Step-by-Step)

### Step 1: Clone and Build Locally
```bash
git clone https://github.com/Shree-varshan-430/Humancraft-UI.git
cd Humancraft-UI
npm install
npm run build
```

---

### Step 2: Add to Antigravity `mcp_config.json`

Open or create your global Antigravity MCP configuration file:

* **Windows**: `%USERPROFILE%\.gemini\config\mcp_config.json`  
  *(e.g., `C:\Users\<YourUsername>\.gemini\config\mcp_config.json`)*
* **macOS / Linux**: `~/.gemini/config/mcp_config.json`

Add the `humancraft` server definition:

```json
{
  "mcpServers": {
    "humancraft": {
      "command": "node",
      "args": [
        "C:/path/to/Humancraft-UI/dist/index.js"
      ]
    }
  }
}
```
*(Replace `C:/path/to/Humancraft-UI` with the absolute path to your cloned directory, using forward slashes `/`)*.

---

### Step 3: Verify and Use in Antigravity

1. **Reload Antigravity**: Start a new chat session.
2. **Verify Discovery**: In Antigravity, click **Additional Options (...) > MCP Servers** to confirm `humancraft` is connected.
3. **Prompt Examples for Antigravity**:
   * *"Use HumanCraft MCP to design a landing page for our database product. Harvest intake first to ensure no default placeholders are used."*
   * *"Run validate_heading_intent on our documentation outline."*
   * *"Generate an empirical comparison table for Redis vs KeyDB using build_comparison_matrix."*

---

## ❓ Frequently Asked Questions (FAQ)

### What is an Antigravity MCP Server?
An Antigravity MCP server connects Google Antigravity to specialized tools, APIs, and workflows via the open **Model Context Protocol (MCP)**. This allows Antigravity to run custom linters, schema builders, and design heuristics directly during generation.

### How does HumanCraft improve website rankings?
HumanCraft enforces Google's **Information Gain** criteria (US Patent 2022/0277032 A1) and **E-E-A-T entity reconciliation**. By replacing generic AI slop headings with outcome-driven headings and building empirical parameter comparison tables, pages avoid algorithmic demotions from Google's SpamBrain.

### Does this MCP increase token usage?
No. HumanCraft uses ultra-compact tool definitions and returns dense, structured JSON diffs, keeping Antigravity token usage identical to baseline.

---

## 🧪 Automated Testing

Run the automated test suite across all 6 tools and security guardrails:
```bash
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)
✔ Security & Hardening Tests (4/4 passed)

Total: 14 passed | 0 failed | Time: ~800ms
```

---

## 📄 License & Backlink Attribution

Distributed under the **MIT License**. See [`LICENSE`](./LICENSE) for details.

Engineered with pride by **[AI Build Infra](https://aibuildinfra.com/)** — Building high-performance infrastructure for artificial intelligence.