TheFaceAnalysis
Face shape rules and a 102-face open measurement dataset. Read-only, no photos.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http thefaceanalysis 'https://mcp.thefaceanalysis.com/mcp'
{
"mcpServers": {
"thefaceanalysis": {
"type": "http",
"url": "https://mcp.thefaceanalysis.com/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
thefaceanalysis-mcp
MCP server for The Face Analysis. It gives an AI assistant sourced, citable face measurement data and the same face shape classifier the site uses. Read-only; it takes no photo.
Tools
| Tool | What it returns |
|---|---|
get_reference_statistics | Percentiles of fWHR, midface ratio, symmetry, golden ratio fit, pupillary distance, canthal tilt on 102 faces (all / women / men) |
list_face_types, get_face_type | Face, eye, lip and nose types: definition and the exact threshold rule |
classify_face_shape | Face shape from four distances, using the site's seven rules in the site's order |
get_methodology | Thresholds, how the score is built, validity against 2,513 raters, change history |
get_citation | Citation text, CC BY 4.0 license, source photo set, downloads |
get_embed_snippet | HTML to put the free face shape widget on a page |
To measure a photo, use https://thefaceanalysis.com/face-shape-detector (free, runs in the browser, no sign-up) or the embeddable widget.
Use
Hosted (no install): add https://mcp.thefaceanalysis.com/mcp as a remote MCP server in your client. Setup guide: https://thefaceanalysis.com/mcp
Local:
{ "mcpServers": { "thefaceanalysis": { "command": "npx", "args": ["-y", "thefaceanalysis-mcp"] } } }
Self-host the HTTP transport: npm run build && PORT=8787 npm run start:http (POST /mcp, stateless).
Honest limits
102 faces from one research set (Face Research Lab London Set), photographed in one city in one month: the numbers describe these faces, not a population. Face type splits show how the detector divides these faces, not how common a type is. No accuracy figure is claimed for any type label. Details: https://thefaceanalysis.com/methodology
Data CC BY 4.0, code MIT.
Questions fréquentes
Qu'est-ce que TheFaceAnalysis ?
Face shape rules and a 102-face open measurement dataset. Read-only, no photos.
Comment installer TheFaceAnalysis ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http thefaceanalysis 'https://mcp.thefaceanalysis.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour TheFaceAnalysis ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
TheFaceAnalysis est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient TheFaceAnalysis ?
Il est publié par The-Face-Analysis. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.