TheFaceAnalysis

com.thefaceanalysis由 thefaceanalysis.com 發布官方發布者v0.1.0更新於 Oct 27, 2026

Face shape rules and a 102-face open measurement dataset. Read-only, no photos.

已驗證Streamable HTTP可網頁執行知識與記憶資料與分析

概覽

AI 產生的概覽

唯讀 MCP 伺服器，提供有出處的臉部測量統計資料、臉型分類門檻規則與臉型分類器，不接收照片。

可以做什麼
  • 查詢 102 張參考臉孔的臉部測量百分位統計，可依全部、女性、男性檢視
  • 列出臉型、眼型、唇型與鼻型，附定義與精確門檻規則
  • 依提供的四個距離，用網站七條規則判定臉型
  • 讀取方法論：特徵點模型、各項門檻、1-10 分數如何組成，以及與人工評分的驗證結果
  • 取得引用文字、授權條款與來源照片集資訊
  • 取得可嵌入網頁的免費臉型小工具 HTML 片段
適用情境
適合需要可引用、有出處的臉部測量數字，或想釐清某個臉型、臉型標籤背後確切判定規則時使用。也適合正確引用這些資料，或把臉型小工具加到網頁上。它不分析照片，照片測量須在網站的瀏覽器小工具中完成。
執行需求
遠端端點 MCP 伺服器加入即可，無須安裝。另提供本機 npm 套件供自架，需要 Node.js，HTTP 傳輸可指定埠號執行。未宣告需要帳號、API 金鑰或請求標頭。
安裝前請注意
唯讀且不接收照片，因此不會上傳影像資料。參考集僅來自一個研究集的 102 張臉孔，拍攝於同一城市同一個月，數字描述的是這些臉而非母體，類型分布只反映偵測器如何劃分這些臉。類型標籤未提供準確率。引用數字須遵守引用與 CC BY 4.0 姓名標示要求，嵌入小工具須保留可見的姓名標示連結。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 TheFaceAnalysis，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.thefaceanalysis%2Fface-analysis/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "thefaceanalysis": {
      "type": "http",
      "url": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}

README

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

ToolWhat it returns
get_reference_statisticsPercentiles of fWHR, midface ratio, symmetry, golden ratio fit, pupillary distance, canthal tilt on 102 faces (all / women / men)
list_face_types, get_face_typeFace, eye, lip and nose types: definition and the exact threshold rule
classify_face_shapeFace shape from four distances, using the site's seven rules in the site's order
get_methodologyThresholds, how the score is built, validity against 2,513 raters, change history
get_citationCitation text, CC BY 4.0 license, source photo set, downloads
get_embed_snippetHTML 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:

json
{ "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.

來源：README.md，提交 d244053

工具

7

get_reference_statistics

Face measurement statistics

Percentiles (p10, p25, median, p75, p90, min, max) of facial measurements from 102 adult faces (49 women, 53 men) of the Face Research Lab London Set, measured with a 478-point MediaPipe landmarker. Measures: composite score, symmetry, golden ratio fit, fWHR, midface ratio, pupillary distance, canthal tilt. Aggregates only; one research set photographed in one city, so these describe these faces, not a population.

輸入參數groupmeasure

list_face_types

List face, eye, lip and nose types

Lists the types the site's detectors use, with slug, name, page URL and how many of the 102 reference faces each type covered. The split shows how the detector divides these faces, not how common a type is in a population.

輸入參數category

get_face_type

Describe one face, eye, lip or nose type

Definition and how the type is measured from a front photo (the exact threshold rule), plus its page URL. Example: category 'face', slug 'oval'.

輸入參數slug必填category必填

classify_face_shape

Classify a face shape from four measurements

Runs the same seven-rule face shape classifier as thefaceanalysis.com/face-shape-detector on four distances (any consistent unit: pixels, mm or landmark units). Returns the shape, the rule that matched and the four ratios. It does not look at photos: to measure a photo, use the widget (get_embed_snippet) or the site. Borderline faces can flip between two shapes; no accuracy figure is claimed because the reference set has no labelled face types.

輸入參數jaw_width必填face_length必填forehead_width必填cheekbone_width必填

get_methodology

Methodology, thresholds and validity

How the numbers are made: the landmark model, every classification threshold, how the 1-10 score is built, and how it correlated with 2,513 human raters on the same faces (it did not predict them). Includes the method change history.

輸入參數include_changelog

get_citation

How to cite the data

Citation text, license (CC BY 4.0 for the aggregate numbers) and the source photo set. Use when quoting a number.

無需輸入參數。

get_embed_snippet

Embed code for the face shape widget

HTML a website owner can paste to add the free face shape finder (it measures the visitor's photo in their browser, no sign-up). Includes the visible credit link the terms ask for.

輸入參數size

版本歷史

1
  1. v0.1.0最新Oct 26, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分