内容
<div align="center">
<img src="docs/logo.svg" width="96" height="96" alt="秦索" />
# 秦索
**用于人工智能代理的确定性事实验证层**
*经过验证的、值得信赖的数据工具，适用于人工智能代理。 "Qiniso" 在祖鲁语中意为 "真相"。*
[官网](https://qinisolabs.github.io/qiniso/) · [npm](https://www.npmjs.com/package/@qinisolabs/qiniso) · [MCP 端点](https://qiniso.qinisolabs.workers.dev/mcp) · [MCP 注册表](https://registry.modelcontextprotocol.io/v0/servers?search=qiniso)
</div>
---
代理自信地发出 IBAN、电话号码、域名、增值税编号和加密货币地址，这些信息微妙地——而且悄悄地——**错误**。 秦索会将代理生成的结构化事实与**校验和和精选的权威数据**进行核对，以便检测到错误的值而不是信任它。
它是确定性补充到防护栏堆栈：安全防护栏检查输出是否**安全**，结构防护栏检查输出是否**格式良好**，而幻觉防护栏会询问另一个大型语言模型以检查输出是否**忠实于提示**。 **它们都不会检查结构化事实是否真正正确，因为这需要计算或精选数据，而不是另一个模型的意见**。 这就是秦索的作用。
> 在任意标识符上，一个前沿的大型语言模型会以 **约 91% 的错误率进行验证，冷启动且无声无息。 秦索：0%。**
## 添加到克劳德
设置 → 连接器 → **添加自定义连接器**，然后粘贴 - 无需登录，无需密钥：
```
https://qiniso.qinisolabs.workers.dev/mcp
```
无状态，不读取用户数据，无需密钥。
## 作为库使用
每个检查也是一个类型化的函数 - 无需 MCP：
```bash
npm i @qinisolabs/qiniso
```
```ts
import { validateIban, validateVat } from "@qinisolabs/qiniso";
validateIban("GB82 WEST 1234 5698 7654 32");
// { valid: true, country: "United Kingdom", ... }
```
## 验证内容 - 8 个领域中的 56 种工具
| 领域 | 工具 |
| --- | --- |
| **标识符** | IBAN、支付卡（Luhn + 品牌）、ISBN-13、VIN、GTIN/UPC/EAN 条形码（+ GS1 国家） |
| **网络 / 网络** | TLD 和域名（IANA 根区）、IP、UUID、URL、电子邮件 |
| **金融** | ISIN、CUSIP、SEDOL、LEI、美国 ABA 路由 |
| **加密货币** | 以太坊（EIP-55）、比特币（Base58Check / Bech32）地址 |
| **国家和税务编号** | 巴西 CPF/CNPJ、南非 ID、西班牙 DNI/NIE、印度 Aadhaar、意大利、波兰、荷兰、比利时、北欧、葡萄牙、土耳其、中国、德国 Steuer-IdNr、法国 NIR、瑞士 AHV、墨西哥 CURP、克罗地亚 OIB、罗马尼亚 CNP、保加利亚 EGN、爱沙尼亚、捷克/斯洛伐克 rodné číslo、欧盟/英国增值税 |
| **学术** | ISBN-10、ISSN、ORCID |
| **地区** | 电话（全球）、日期解析、货币、节假日（约 200 个国家）、英国按日期划分的增值税 |
| **地址** | 英国 / 美国地址解析 |
每个工具都封装了一个权威方法 - 公开的校验和标准、审计库（libphonenumber-js、jsvat、date-holidays、@noble/hashes）或精选参考数据（IANA 根区、英国增值税历史）。
## 它不是什么
- **不是实时数据提供商**。 它验证您提供给它的事实； 它不返回当前时间、天气或实时汇率。
- **不是凭证接收器**。 它从不要求机密或 API 密钥。 （对于 JWT 签名验证，请在您自己的运行时使用一个库，以便密钥永远不会离开您的机器。）
- **不是注册检查**。 它验证增值税编号的校验和，而不是它是否实时注册（VIES）； 它确认域名的 TLD 是真实的，而不是域名已注册。
## 架构
一个 TypeScript 多仓库。 每个域都是 `packages/*` 中的一个类型化库； `qiniso` 伞形聚合它们，并通过三种传输方式公开一个 MCP 服务器 - **stdio** （本地 / `npx`）、**Streamable HTTP** （自托管）和 **Cloudflare Worker** （托管边缘端点）。 相同的核心为可导入的库提供支持。
```bash
npm install
npm run build
npm test
```
## 许可证
Apache-2.0
