# @fairquery/agent-trust-mcp 中文文档

规范地址：https://npmcn.com/package/%40fairquery/agent-trust-mcp/

版本：1\.1\.10
npm 元数据更新时间：2026-10-26T04:39:46.462Z
中文译文更新时间：2026-11-14T09:07:56.926Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fairquery/agent-trust-mcp
原文对照：https://npmcn.com/package/%40fairquery/agent-trust-mcp/?lang=original
项目主页：https://getfairquery.com/posts/give-ai-agent-trust-safety-tools-mcp-server/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：420 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2026-10-17T02:26:27.197Z
- 最新版本发布：2026-10-26T04:39:46.289Z
- 近 30 天下载量：4526（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

Fairquery Agent Trust & Data Safety MCP服务器:PII/机密编辑,电子邮件验证,制裁筛选,依赖性检查和本地的MCP服务器预检AI代理. 免费本地工具+可选付费 辅助后盾深层工具.

## 安装

```sh
npm install @fairquery/agent-trust-mcp
```

也可以使用：`pnpm add @fairquery/agent-trust-mcp`、`yarn add @fairquery/agent-trust-mcp`、`bun add @fairquery/agent-trust-mcp`

## README

# Fairquery Agent 信托和数据安全( MCP 服务器)

一个处理不可信数据的AI代理的MCP服务器. 它包括四项工作:

-   **PII 和秘密编辑**:在文本达到LLM前检查文本.
-   **电子邮件检查**:语法,打字,可支配和角色地址,加上付费工具中的MX/SPF/DMARC.
-   **制裁筛选**:外国资产管制处、欧盟、联合王国和联合国名单.
-   **依赖的脆弱性**:对OSV.dev进行观察.
-   **MCP 服务器预选**:在安装或启用服务器之前对工具名称和描述进行局部扫描.

**免费工具不需要任何代号或账户,并运行在您的机器上.** 付费工具是可选的。 他们叫公众Fairquery 协助演员 _你们自己_ `APIFY_TOKEN`,运行时会向您的补充账户开出账单.

## 工具

| 工具 | 费用 | 它会做什么 |
| --- | --- | --- |
| `pii_list_detectors` | 免费( 本地) | 探测器目录、编辑样式和每个付费工具的定价 |
| `pii_scan_text` | 免费( 本地) | 查找PII和文本中的秘密,包括亚洲国家ID包. 检测结果只显示被掩盖的值 |
| `pii_redact_text` | 免费( 本地) | 带有占位符,口罩或散列样式的剪接. 可以返回占位符地图 |
| `pii_restore_text` | 免费( 本地) | 使用该地图将原始值重新放入占位符文本( 例如 LLM 答案); 列出地图未覆盖的占位符 |
| `pii_guard_documents` | 1.50 1 000份文件+0.20 1 000个调查结果 | 添加 NER 名称/地址、 URL 和 PDF, 并恢复模式 |
| `email_check_syntax` | 免费( 本地) | 语法、正常化、类型建议、可支配/作用/免费提供的旗帜 |
| `email_validate_deliverability` | 0.79 1 000美元电子邮件 | DNS/MX,无效MX,SPF/DMARC,邮件供应商,判决 |
| `sanctions_list_sources` | 免费( 本地) | 涵盖的清单、签发当局、免责声明 |
| `sanctions_screen_names` | 3.00/1 000美元姓名+7.00/1 000美元的电话 | 针对外国资产管制处SDN/合并、欧盟、联合王国和联合国的模糊筛选 |
| `osv_query_packages` | 免费( api.osv.dev) | 脆弱与否,加上咨询身份证,最多200个准确版本 |
| `osv_get_vulnerability` | 免费( api.osv.dev) | 完整的OSV咨询记录 |
| `osv_audit_dependencies` | 0.50 1 000个包+ 1.50 1 000瓦特 | 附有严重性、修正和建议版本的明细/归档审计 |
| `trust_screen_lead` | 0.79.1万个电子邮件+ 3.00/1万个名字+ 7.00/1万个电话 | 电子邮件检查和制裁检查平行进行,合并为每个线索的通过/审查/区块决定 |
| `mcp_server_precheck` | 免费本地扫描. 可选付酬审计:0.50 1 000美元包+ 1.50 1 000 vulns | 扫描工具名称和描述以进行注射,隐藏标记和交叉服务器跟踪. 扫描机里没有东西离开. `auditDependencies: true` 还要审核本地的锁文件,增加许可证和公布时间 |

每个工具描述都有什么 / 当 / 当 不 / 成本 / 返回 / EXAMPL 部分 。 产出为:`limit`, (中文(简体) ), `offset`, (中文(简体) ), `nextOffset`, (中文(简体) ), `hasMore`) (中文(简体) ). 错误使用命名代码 : `APIFY_TOKEN_MISSING`, (中文(简体) ), `APIFY_TOKEN_INVALID`, (中文(简体) ), `APIFY_PAYMENT_REQUIRED`, (中文(简体) ), `APIFY_ACTOR_RUN_FAILED`, (中文(简体) ), `APIFY_TIMEOUT`, (中文(简体) ), `INPUT_EMPTY`, (中文(简体) ), `INPUT_TOO_LARGE`, (中文(简体) ), `INVALID_ECOSYSTEM`, (中文(简体) ), `INVALID_JSON`, (中文(简体) ), `INVALID_PACKAGE_NAME`, (中文(简体) ), `PATH_NOT_FOUND`, (中文(简体) ), `PATH_NOT_ALLOWED`, (中文(简体) ), `OSV_FETCH_FAILED` 财务报告和审定财务报表 `VULN_NOT_FOUND`。 。 。 .

付费工具使用这些辅助演员:

-   [`fairquery/llm-data-guard-pii-secrets`](https://apify.com/fairquery/llm-data-guard-pii-secrets) 页:1 `pii_guard_documents`,从根据《说明》业务计划处理的每1 000个文件的0.99美元(免费1.50美元)。 每起运行费为每起运行0.05美元.
-   [`fairquery/email-validator-mx-disposable`](https://apify.com/fairquery/email-validator-mx-disposable) 页:1 `email_validate_deliverability` 财务报告和审定财务报表 `trust_screen_lead`,从Apify商业计划及以上(免费0.79美元)检查的每1 000个电子邮件0.59美元。 每起运行费为每起运行0.05美元.
-   [`fairquery/sanctions-watchlist-screener`](https://apify.com/fairquery/sanctions-watchlist-screener) 页:1 `sanctions_screen_names` 财务报告和审定财务报表 `trust_screen_lead`,从Public's Business Plan和以上(免费3.00美元)上筛选的每千人2.10美元。 每跑出站费为每跑出站费7.00元.
-   [`fairquery/osv-dependency-vulnerability-check`](https://apify.com/fairquery/osv-dependency-vulnerability-check) 页:1 `osv_audit_dependencies`,从检查的每1 000个包0.35美元和《补充》业务计划及以上(免费0.50美元和1.50美元)发现的每1 000个弱点1.0美元。 每起运行费为每起运行0.05美元.

价格如2026-10-24年度的"说明"商店所显示.

## 何时使用哪个工具

| 你想说.. | 使用 | 费用 |
| --- | --- | --- |
| 在PII和秘密达到LLM前,请检查一个快速,罚单或日志 | `pii_scan_text`,则 `pii_redact_text` | 免费, 本地 |
| 将原始值放回 LLM 之后的答案 `pii_redact_text` | `pii_restore_text` | 免费, 本地 |
| 还抓取名称和地址,或扫描 PDF 或 URL | `pii_guard_documents` | 已支付 |
| 在报名表上记录打字、一次性地址或角色地址 | `email_check_syntax` | 免费, 本地 |
| 请检查access-date=中的日期值 (帮助) 邮件域名可以接收邮件(MX,无效MX,SPF/DMARC) | `email_validate_deliverability` | 已支付 |
| 查看涵盖哪些制裁清单和免责声明 | `sanctions_list_sources` | 免费, 本地 |
| 对外国资产管制处、欧盟、联合王国和联合国的制裁名单进行甄别 | `sanctions_screen_names` | 已支付 |
| 获得新线索的通过/审查/区块决定(电子邮件和名称合并) | `trust_screen_lead` | 已支付 |
| 查找准确的软件包版本是否知道存在弱点 | `osv_query_packages`,则 `osv_get_vulnerability` 详情 | 免费( api.osv.dev) |
| 审计一份完整的清单或装有严重性、固定性和建议性版本的文件 | `osv_audit_dependencies` | 已支付 |
| 在安装或启用前预先检查 MCP 服务器的工具描述 | `mcp_server_precheck` | 免费, 本地 |
| 同时审计服务器的依赖性和记录许可和发布时间 | `mcp_server_precheck` 与 `auditDependencies: true` | 支付OSV审计费用 |

从免费工具开始。 使用付费工具时,您需要该工具添加的内容;每一次付费电话都会在您自己的信使上开具一个认证代理.

### 亚洲国家ID包

`pii_scan_text` 财务报告和审定财务报表 `pii_redact_text` 在当地发现这些国民身份证。 只有在检查和(如果有)结构检查通过时,才报告一个值。 失败的检查被忽略 。 面具风格保留了最后四个字符,与US SSN相同 `risk_level` 这是高.

| 类型 | 文档 | 检查什么 |
| --- | --- | --- |
| `IN_AADHAAR` | 印度 | 12个数字,第一个数字2-9,Verhoeff检查。 允许带空格或连字符的四人组. |
| `IN_PAN` | 印度 PAN | 五个字母,四个数字,一个字母。 第4个字符为持有者类型(P,C,H,F,A,T,B,L,J,G). PAN没有支票和. |
| `IN_GSTIN` | 印度 GSTIN | 15个字符: 国号01-38,97或99,持有者的PAN,一个实体代码,字母Z,和一个mod-36检查字符. |
| `KR_RRN` | 韩国居民登记号(QQ) | 13个数字,一个真正的出生日期, 加权的mod-11检查数字。 2020年10月后随机计划下发布的数字没有检查数字,也不匹配. |
| `JP_MY_NUMBER` | 日本我的号码( QQ) | 12位数字和来自内政部法令的支票数字(从右边的重量,Mod 11). |
| `SG_NRIC` | 新加坡 NRIC / FIN | 前缀"S","T","F","G"或"M"等7位数字,并有"支票和"字母. |
| `VN_CCCD` | 越南公民身份证 | 12位数字:省代码出自第07/2016/TT-BCA号通告(在2025年并购后仍为卡片前缀),世纪/性别数字,以及未来没有的诞生年份. 计划没有校验和,所以发现的是中度自信. |
| `TW_NATIONAL_ID` | 台湾国民身份证 | 地区字母,性别或居民代码(1,2,8,9,A-D)和mod-10检查. |
| `CN_RESIDENT_ID` | 中国居民身份证 | 18个字符 省代码 一个真实的出生日期 ISO 7064 mod 11-2检查. 最后一个角色可能是X. |

### 预检查 MCP 服务器

免费电话只扫描你已经拥有的东西. 它不安装软件包,不启动软件包,也不向任何地方发送工具名称和描述.

```json
{
  "name": "mcp_server_precheck",
  "arguments": {
    "tools": [
      { "name": "sum", "description": "Add two numbers." }
    ]
  }
}
```

一个干净的描述回来 `meta.risk_level` 联 合 国 `none` 财务报告和审定财务报表 `meta.shared_externally.tool_names_and_descriptions` 联 合 国 `false`。如果发现有的话,就是有 `rule` 例如 `PROMPT_INJECTION`, (中文(简体) ), `SECRET_EXFILTRATION`, (中文(简体) ), `HIDDEN_INSTRUCTION`, (中文(简体) ), `CONCEALED_TEXT` 或者说 `CROSS_SERVER_REFERENCE`。 。 。 .

你可以指点 `path` 当地离职或离职 `.json` 工具/列表文件,或通过 `packageName` 用于已安装的软件包 `node_modules`。如果名称不在磁盘上,则结果会如此,不会下载.

付费模式是相同的扫描加依赖性审计. 这需要 `APIFY_TOKEN` 以及当地 `package.json` 或者说 `package-lock.json`。许可和发布年龄来自当地清单,当软件包不是私人标记时,则对软件包名称进行公共npm注册查询。 工具描述仍未上传 .

```json
{
  "name": "mcp_server_precheck",
  "arguments": {
    "path": "/absolute/path/to/the-mcp-package",
    "auditDependencies": true
  }
}
```

没有标志 当地调查结论仍然在回落 `dependency_audit` 列已经 `error_code` `APIFY_TOKEN_MISSING`。 。 。 .

## 安装

要求节点.js 20或更晚. `APIFY_TOKEN` 这是可选的,并且只用于有偿工具。 来一个 [https://console.apify.com/ settings/ 整合(英语:](https://console.apify.com/settings/integrations)。 。 。 .

快速启动( stdio) :

```bash
npx -y @fairquery/agent-trust-mcp
```

下面的配置运行 [npm 软件包](https://www.npmjs.com/package/@fairquery/agent-trust-mcp) 与 `npx -y`: 不需要克隆或构建步骤.

### Claude 桌面 (`claude_desktop_config.json`(中文(简体) )

```json
{
  "mcpServers": {
    "fairquery-trust": {
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "<optional-your-apify-token>" }
    }
  }
}
```

### 光标( C)`~/.cursor/mcp.json` 或者说 `.cursor/mcp.json`(中文(简体) )

```json
{
  "mcpServers": {
    "fairquery-trust": {
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "<optional-your-apify-token>" }
    }
  }
}
```

### VS 代码 (`.vscode/mcp.json`(中文(简体) )

```json
{
  "inputs": [{ "type": "promptString", "id": "apify-token", "description": "Apify token (optional, paid tools only)", "password": true }],
  "servers": {
    "fairquery-trust": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "${input:apify-token}" }
    }
  }
}
```

### 双子座CLI(`~/.gemini/settings.json`(中文(简体) )

```json
{
  "mcpServers": {
    "fairquery-trust": {
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "<optional-your-apify-token>" }
    }
  }
}
```

### 可流取的 HTTP

```bash
npx -y @fairquery/agent-trust-mcp --http   # Streamable HTTP on http://127.0.0.1:3000/mcp (PORT, HOST env)
```

### MCPB 捆绑( Smithery 本地安装, Claude 桌面)

`manifest.json` 描述一个 [MCPB 软件](https://github.com/modelcontextprotocol/mcpb) 运行本地服务器的捆绑 捆绑要求有一个可选的敏感设置: **你们自己** 认证 API 令牌 。 留空只用自由工具.

```bash
npm run build:mcpb   # -> build/fairquery-agent-trust-mcp-<version>.mcpb (dist + production node_modules)
npm run test:mcpb    # unpack, initialize, tools/list, free call, paid call without token -> APIFY_TOKEN_MISSING
```

`build:mcpb` 还写 `<name>-smithery.mcpb`上传到Smithery的文件。 同样的捆绑,只有 `manifest.json` 更改:每个工具还带有其 `inputSchema`, (中文(简体) ), `outputSchema` 财务报告和审定财务报表 `annotations`,从服务器本身取出 `tools/list`. Smithery 的发布 API 需要这些用于它的服务器卡, 但是 MCPB 0.3 显示的 schema 仅允许 `name`编号 :`description` 每一个工具,所以峡谷 `.mcpb` 保持光谱验证显示. `test:mcpb` 测试捆绑和检查 它们只在这些工具计划中有所不同.

## 测试

```bash
npm run smoke        # initialize + tools/list + guide/annotation checks, Asia national-ID vectors, no token
npm run test:live    # every free tool live, ReDoS probes, paid tools without token -> APIFY_TOKEN_MISSING
npm run test:paid    # also ONE paid call per family using APIFY_TOKEN from env (costs < $0.02)
```

## 警卫

见 [https://getfairquery.com/security/ (中文(中国大陆) )](https://getfairquery.com/security/)免费工具从不与 Apify 或 Fairquery 联系,代码中没有任何秘密 . `mcp_server_precheck` 不在任何地方发送工具描述。 与 `auditDependencies: true` 它会向OSV Actor发送本地运算表,并且,除非包是私下标出,否则将包名发送给公共npm注册.

## 免责声明

制裁结果来自自动模糊匹配,不是经认证的筛选服务。 检查每一个潜在的匹配自己。 电子邮件检查不会探测SMTP邮箱.

## 许可证

麻省理工学院

## 常见问题

### @fairquery/agent-trust-mcp 是什么？

Fairquery Agent Trust & Data Safety MCP服务器:PII/机密编辑,电子邮件验证,制裁筛选,依赖性检查和本地的MCP服务器预检AI代理\. 免费本地工具\+可选付费 辅助后盾深层工具\.

### 如何安装 @fairquery/agent-trust-mcp？

在项目目录运行 npm install @fairquery/agent-trust-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fairquery-agent-trust-mcp，可以用 npx fairquery-agent-trust-mcp 直接运行。

### @fairquery/agent-trust-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fairquery\_\_agent-trust-mcp 是否存在。

### @fairquery/agent-trust-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fairquery/agent-trust-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fairquery/agent-trust-mcp 可以商用吗？

@fairquery/agent-trust-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fairquery/agent-trust-mcp 的下载量有多少？

根据 npm 官方下载统计，@fairquery/agent-trust-mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 4,526 次，日均约 151 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fairquery/agent-trust-mcp 还在维护吗？

最新版本 1\.1\.10 发布于 2026/10/26（19 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/10/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。