关于 mcp-unico
mcp-unico 是巴西身份验证服务 Unico 的 MCP 服务，提供 CPF/CNPJ 校验、证件 OCR、人脸比对、活体检测及 PEP、制裁名单和法院记录筛查。README 声明该包已弃用，所列默认端点无法解析，当前不能调用真实服务。
主要功能
- 01CPF 与 CNPJ 校验
- 02证件 OCR 与真伪检测
- 03人脸比对与活体检测
- 04PEP、制裁名单与法院记录筛查
- 05Unico Score 风险评分
- 06验证流程状态查询与 Webhook 管理
适用场景
- 01为巴西市场的卖家入驻或高价值交易执行身份核验（已弃用，仅供参考）
- 02为受 KYC 监管的流程设计身份筛查工具调用
- 03参考巴西身份验证产品的 MCP 工具划分方式
MCP 相关
该项目是 MCP 服务，向 MCP 客户端暴露 18 个身份验证相关工具，使用 OAuth 2.0 客户端凭证访问 Unico 接口。默认端点当前不可用，需通过环境变量指定其他地址。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @codespar/mcp-unicoUNICO_CLIENT_IDUnico OAuth client_idUNICO_CLIENT_SECRET密钥Unico OAuth client_secretUNICO_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.UNICO_BASE_URLOptional override for the IDCloud/IDPay/IDCheck API base URL. Defaults to https://api.unico.co.UNICO_AUTH_URL密钥Optional override for the OAuth token endpoint base URL. Defaults to https://auth.unico.co.本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
@codespar/mcp-unico
已弃用：没有可用的端点。 2026-09-27 通过两个公共 DNS 解析器（8.8.8.8 和 1.1.1.1）进行测量：
api.unico.co（API）和auth.unico.co（令牌）无法通过 DNS 解析。Unico 的开发者文档现在将api.id.unico.app/api.id.uat.unico.app列为 API 地址，将identity.acesso.io/identityhomolog.acesso.io列为 OAuth 地址；本服务的路径和身份验证并非针对这些地址编写，也尚未经过验证。本服务中的工具均无法连接到服务。该软件包已在 npm 上弃用，仅保留在此代码库中供参考。如果你有可用的端点，可通过UNICO_BASE_URL和UNICO_AUTH_URL将服务指向该端点。要恢复该软件包，请在 mcp-dev-latam 中提交问题，并附上服务提供商文档中记录的基础 URL。
面向 Unico 的 MCP 服务——巴西领先的身份验证服务。提供 CPF/CNPJ 验证、证件 OCR、人脸生物识别、活体检测，以及 PEP / 观察名单 / 法院记录筛查。
CodeSpar identity 类别中的首个项目。为卖家办理入驻的电商 Agent（市场平台）、处理高价值交易或运行受 KYC 监管流程的 Agent 都需要身份验证——Unico 是巴西标准。搭配 @codespar/mcp-onfido，即可覆盖巴西优先及全球范围。
产品
Unico 销售三种需单独签约的产品。本服务为这三种产品都提供工具；Agent 应只调用合同中启用的产品（未启用的产品会返回 403）。
| 产品 | 功能 |
|---|---|
| IDCloud | 通过 Receita Federal 验证 CPF/CNPJ、证件 OCR 和真伪鉴定 |
| IDPay | 用于登录和支付身份验证的人脸比对与活体检测 |
| IDCheck | PEP、制裁观察名单、巴西法院记录 |
工具（18）
| 工具 | 用途 |
|---|---|
validate_cpf | IDCloud：通过 Receita Federal 验证巴西 CPF。 |
validate_cnpj | IDCloud：通过 Receita Federal 验证巴西 CNPJ。 |
extract_document | IDCloud：对巴西身份证件图像进行 OCR，并提取结构化字段。 |
verify_document_authenticity | IDCloud：检测证件图像是否被篡改或伪造。 |
face_match | IDPay：对实时自拍照与证件照片进行生物特征一对一比对。 |
liveness_check | IDPay：被动活体检测。 |
check_pep | IDCheck：政治公众人物筛查。 |
check_watchlists | IDCheck：全球制裁名单 / 负面媒体筛查。 |
court_records_search | IDCheck：巴西司法记录搜索。 |
get_process_status | IDCheck：轮询此前通过 Unico Web/Mobile SDK 或 API 创建的验证流程状态。 |
batch_get_process_status | IDCheck：批量查询状态。 |
upload_process_document | IDCheck：将采集的图像上传到正在运行的验证流程。 |
get_extracted_data | IDCheck：获取已完成流程的结构化 OCR 结果 — 类型化字段（姓名、证件号码、发行机构…… |
get_unico_score | IDCheck：Unico Score — 巴西身份欺诈风险评分（0-1000，分数越高 = 风险越低），根据 Unico……计算 |
connect_portability_check | Connect：跨租户可移植性检查。 |
register_webhook | Webhooks：订阅回调 URL，以接收 Unico 流程事件（process.created、process.finished、proc…… |
list_webhooks | Webhooks：列出为此租户注册的所有 Webhook 订阅。 |
delete_webhook | Webhooks：移除 Webhook 订阅。 |
安装
npm install @codespar/mcp-unico@alpha
环境变量
UNICO_CLIENT_ID="..." # OAuth client_id
UNICO_CLIENT_SECRET="..." # OAuth client_secret
UNICO_ENV="sandbox" # Optional. 'sandbox' | 'production'. Default: sandbox
UNICO_BASE_URL="..." # Optional. Default: https://api.unico.co
UNICO_AUTH_URL="..." # Optional. Default: https://auth.unico.co
身份验证
OAuth 2.0 客户端凭据。服务器会将 client_id:client_secret 作为 Basic 身份验证信息发送到 Unico 的令牌端点，并在内存中缓存持有者令牌，直到令牌过期前 60 s。Unico 的文档要求仅进行服务器端集成——切勿将这些凭据暴露给浏览器或移动客户端。
运行
# stdio (default)
npx @codespar/mcp-unico
# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-unico
状态
已作为 0.1.0-alpha.1 发布。Unico 的 REST 接口规范位于 devcenter.unico.io 门户中，且需要商户账户才能访问。工具名称和参数形式稳定，但在使用有效凭据验证之前，具体端点路径可能会调整——如果你的账户由其他主机提供服务，请覆盖 UNICO_BASE_URL / UNICO_AUTH_URL。欢迎在了解实际载荷后提交 PR。
企业版
需要为 Agent 支付添加治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。