git clone https://github.com/AndyZhuang/opencosmetics.git
cd opencosmetics
npm install
npm run dev
# → http://localhost:3000

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "opencosmetics": {
      "command": "node",
      "args": ["/path/to/opencosmetics/mcp-server/dist/index.js"]
    }
  }
}

duckdb data/bebd.duckdb
> SELECT * FROM cn_iecic_i WHERE inci_name ILIKE '%RETINOL%' LIMIT 5;
> SELECT * FROM annex_ii_prohibited WHERE LOWER("Chemical name / INN") LIKE '%nitroglycerin%';

# Formula review / 配方风险审查
curl -X POST http://localhost:3000/api/risk/check \
  -H "Content-Type: application/json" \
  -d '{"ingredients": ["RETINOL", "AHA", "VITAMIN_C"], "context": {"population": "pregnant", "region": "CN"}}'
# → {"summary": "REJECT", "block_count": 3, "warn_count": 5, "findings": [...], "lang": "both"}

opencosmetics/
├── app/                          # Next.js 15 App Router
│   ├── page.js                   # Home: 5 sources + Killer Finding
│   ├── ingredients/              # Ingredients (50K)
│   ├── regulatory/               # EU Regulatory
│   ├── fda/                      # FDA 85K events
│   ├── china/                    # 🇨🇳 NMPA 8,985 + GB 7916-2026
│   ├── synbio/                   # 🧬 Juzi/Jinbo/Huaxi/Chuangjian
│   ├── risk/                     # ⚖️ 65-rule review
│   └── api/
│       ├── mcp/route.js          # MCP HTTP entry
│       ├── china/ingredient/     # Chinese ingredient query
│       ├── synbio/companies/     # Synbio companies
│       ├── risk/check/           # Risk review
│       ├── regions/              # Multi-region compliance
│       └── stats/                # Aggregate stats
├── lib/
│   ├── db.js                     # DuckDB singleton + risk engine
│   └── i18n.js                   # i18n dictionary (zh/en/both)
├── components/
│   ├── LangSwitcher.js           # 3-state language switcher
│   └── Bilingual.js              # Bilingual field component
├── data/
│   ├── bebd.duckdb               # 17 MB — 25 tables (EU+CN+US)
│   ├── companies.json            # 4 synbio companies
│   └── rules.json                # 65 risk rules
├── mcp-server/                   # TypeScript stdio MCP server
│   ├── src/index.ts              # 4 tools
│   ├── dist/index.js             # 11.3 KB compiled
│   └── package.json
├── scripts/                      # Data ingest pipeline
│   ├── 01_download_sources.py
│   └── 02_merge_duckdb.py
└── docs/
    ├── ARCHITECTURE.md
    └── MCP.md