工具说明

总览：刷掌平台 MCP 提供掌纹注册、1:1 比对、1:N 检索、删除等能力。

RegisterRgbPalm — 注册 RGB 掌纹

功能：将一张已上传的 RGB 掌纹图片绑定到指定用户，生成对应的掌纹 ID；当用户已存在掌纹时，可通过 IsForce 决定是否强制覆盖。

参数：

字段	类型	必填	说明
RgbImage	object	✅	RGB 掌纹图片对象
RgbImage.Data	string	✅	【图片 Path 字段】图片对应的对象 Path
RgbImage.ImageType	integer	✅	图像类型，固定填 1（RGB）。
UserId	string	✅	用户 ID，掌纹将归属到该用户
IsForce	boolean	❌	当用户已存在掌纹时是否强制覆盖，默认 false

若使用 User Token，数据操作范围为个人手掌，注册手掌时需输入官网注册的 userID。

返回：

字段	类型	说明
PalmId	string	掌纹 ID

---

CompareRgbPalm — RGB 掌纹 1:1 比对

功能：将一张 RGB 掌纹图与指定用户已注册的掌纹进行一对一比对，返回是否匹配、匹配分、算法版本以及手掌方向。

参数：

字段	类型	必填	说明
RgbImage	object	✅	待比对的 RGB 掌纹图片对象
RgbImage.Data	string	✅	【图片 Path 字段】图片对应的对象 Path
RgbImage.ImageType	integer	❌	图像类型，固定填 1（RGB）。
CompareUserId	string	✅	目标用户 ID，即被比对方的用户 ID

返回：

字段	类型	说明
IsMatch	boolean	是否匹配
Score	integer	匹配分，范围 0-100
AlgorithmVersion	string	算法版本
PalmDirection	integer	手掌方向。1=LEFT_PALM、2=RIGHT_PALM

---

SearchRgbPalm — RGB 掌纹 1:N 检索

功能：在掌纹大库中检索与输入图最相似的用户，返回命中用户 ID、匹配分、算法版本以及手掌方向，常用于身份核验场景。

参数：

字段	类型	必填	说明
RgbImage	object	✅	待检索的 RGB 掌纹图片对象
RgbImage.Data	string	✅	【图片 Path 字段】图片对应的对象 Path
RgbImage.ImageType	integer	❌	图像类型，固定填 1（RGB）。

返回：

字段	类型	说明
UserId	string	命中用户 ID
Score	integer	匹配分，范围 0-100
AlgorithmVersion	string	算法版本
PalmDirection	integer	手掌方向。1=LEFT_PALM、2=RIGHT_PALM

---

DeletePalm — 删除掌纹

功能：删除指定用户的掌纹数据，可按手掌方向精细化删除；当 PalmDirectionList 为空数组时，表示删除该用户所有方向的掌纹。

参数：

字段	类型	必填	说明
UserId	string	✅	用户 ID，要删除掌纹的归属用户
PalmDirectionList	array<integer>	✅	要删除的掌纹方向列表，元素枚举：1=LEFT_PALM、2=RIGHT_PALM；传空数组 [] 表示删除全部方向

返回：无业务字段（成功即表示删除完成）。