ztds

ztds-mcp & ztds-audit — 零信任数据脱敏（ZTDS™ RFC v1.0）MCP 服务与不变量审计器

此代码库包含符合 零信任数据脱敏（ZTDS™ RFC v1.0） 标准的官方 Model Context Protocol（MCP）服务实现（ztds-mcp） 和 代码库不变量审计器（ztds-audit）。由 ZTDS AI Consortium 维护。

• MCP 服务源代码（位于此代码库中）：packages/ztds-mcp/index.js
• MCP 清单与服务卡片：packages/ztds-mcp/manifest.json | server-card.json | smithery.yaml
• MCP 服务测试套件：packages/ztds-mcp/test.js
• 命令行不变量审计器：bin/ztds-audit.js

ZTDS™ 规范了 AI Agent、IDE 助手（Claude Desktop、Claude Code、Cursor、Windsurf、Zed）、检索增强生成（RAG）和大语言模型（LLM）工作流中的内存数据脱敏。它 100% 在设备易失性内存（RAM）中本地执行，不进行任何外部网络调用、不写入磁盘，也不使用子处理器。

---

1. MCP 服务实现（ztds-mcp）

参考 MCP 服务（packages/ztds-mcp/index.js）通过 stdio JSON-RPC 2.0 传输实现 Model Context Protocol（2024-11-05），且没有外部运行时依赖。它会在客户端 RAM 中、LLM 调用前拦截敏感明文（PII、PHI、API 密钥、IBAN、信用卡），将其替换为确定性替代令牌（[EMAIL_TOKEN_1]、[API_SECRET_TOKEN_1]），并在 LLM 响应中于本地恢复真实值。

1.1 安装与 MCP 客户端配置

选项 A：一键自动设置

npx ztds-mcp init

选项 B：Claude Desktop（claude_desktop_config.json）与 Cursor IDE（.cursor/mcp.json）

{
  "mcpServers": {
    "ztds": {
      "command": "npx",
      "args": ["-y", "ztds-mcp"]
    }
  }
}

选项 C：直接从代码库源代码运行

{
  "mcpServers": {
    "ztds": {
      "command": "node",
      "args": ["/absolute/path/to/ztds.ai/packages/ztds-mcp/index.js"]
    }
  }
}

选项 D：Claude Code CLI

claude mcp add ztds -- npx -y ztds-mcp

---

1.2 MCP 工具（tools/list 和 tools/call）

在 packages/ztds-mcp/index.js 中实现：

工具名称	输入架构（properties）	描述
ztds_sanitize	text（string，必填），sessionId（string，可选）	在客户端易失性 RAM 中，将敏感个人身份信息（PII）、受保护健康信息（PHI）和凭证替换为确定性代理令牌（[EMAIL_TOKEN_1]、[API_SECRET_TOKEN_1]），再交由大模型处理，并生成加密 SHA-256 ZTDS-RECEIPT-* 证明。
ztds_restore	text（string，必填），sessionId（string，可选）	在易失性 RAM 中，通过原子单次查找从代理令牌本地还原原始未脱敏明文（防止二阶令牌注入）。
ztds_audit	text（string，必填）	根据 ZTDS RFC v1.0 审计文本或文件内容是否暴露凭证和个人身份信息，并返回类别明细、风险等级（LOW/HIGH/CRITICAL）以及 SHA-256 合规收据。
ztds_info	{}（无参数）	返回当前有效的 ZTDS RFC v1.0 协议状态、IETF 标准跟踪元数据以及易失性 RAM 会话指标。
ztds_reset_session	sessionId（string，可选）	显式清零并销毁易失性内存中的代理映射表（定理 2：RAM 清零）。

JSON-RPC tools/call 示例（ztds_sanitize -> ztds_restore）

请求（ztds_sanitize）：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ztds_sanitize",
    "arguments": {
      "text": "Customer [email protected] reported failure with key sk-proj-demo-key.",
      "sessionId": "ide-session-01"
    }
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Customer [EMAIL_TOKEN_1] reported failure with key [API_SECRET_TOKEN_1].\n\n> [ZTDS Invariant 1 Attested] Zero external network egress.\n> Receipt: ZTDS-RECEIPT-8F4B2C19E0A3D712 | Execution: 42µs | Entities Masked: 2"
      }
    ],
    "isError": false
  }
}

---

1.3 MCP 资源（resources/list 和 resources/read）

MCP 服务通过 resources/list 和 resources/read 提供结构化的只读协议与遥测资源：

资源 URI	MIME 类型	描述
ztds://spec/rfc-v1	application/json	正式的 ZTDS RFC v1.0 / IETF draft-sibiryakov-ztds-protocol 规范元数据及 4 项核心数学不变量。
ztds://session/telemetry	application/json	实时易失性 RAM 会话数量、容量限制以及零外流证明状态（无明文暴露）。

---

1.4 MCP 提示词（prompts/list 和 prompts/get）

提示词名称	参数	描述
ztds_guard	task（string，必填）	为当前 IDE/Agent 工作流启用 ZTDS 零信任数据清理防护措施，指示模型在进行外部推理前调用 ztds_sanitize，并在输出时调用 ztds_restore。

---

1.5 程序化 / Node.js SDK 用法（packages/ztds-mcp/index.js）

MCP 服务模块导出其 JSON-RPC 分发器和内存清理原语，以便直接进行程序化集成和测试：

import {
  handleMessage,
  sanitizeText,
  restoreText,
  auditText,
  resetSessionStore,
  TOOLS,
  PROMPTS,
  RESOURCES
} from './packages/ztds-mcp/index.js';

// 1. Direct in-memory sanitization & restoration
const scrubbed = sanitizeText('Send wire to DE89370400440532013000 for [email protected]', 'session-1');
console.log(scrubbed.sanitizedText); // "Send wire to [IBAN_TOKEN_1] for [EMAIL_TOKEN_1]"

const restored = restoreText(`Confirmed transfer to ${scrubbed.sanitizedText}`, 'session-1');
console.log(restored.restoredText);

// 2. Direct MCP JSON-RPC 2.0 protocol invocation
const rpcResponse = await handleMessage({
  jsonrpc: '2.0',
  id: 1,
  method: 'tools/list',
  params: {}
});

// 3. Zeroize volatile session memory (Theorem 2)
resetSessionStore('session-1');

在本地运行 MCP 服务验证套件：

node packages/ztds-mcp/test.js

---

2. 4 项基本不变量（RFC v1.0）

ztds-mcp 保护并由 ztds-audit 审计的每条 AI 流水线，都会根据 4 项核心数学和架构不变量进行验证：

1. 不变量 1：清理前不向外部传输数据：可逆代理令牌化之前，原始敏感明文（PII、PHI、API 密钥、私人财务号码）绝不能越过本地执行边界。
2. 不变量 2：确定性可逆令牌化：必须保留语义、语法和结构上下文以供大模型推理，同时将去标识化查找表严格保存在本地主机的易失性内存中。
3. 不变量 3：加密与内存隔离：操作在易失性堆或经过硬件证明的隔离环境（WASM、Nitro Enclaves、C-ABI）中运行，不向磁盘写入未加密数据，并立即清零内存。
4. 不变量 4：持续排除子处理方：在本地客户端执行可消除向第三方传输数据的情况，依法免除部署遵守 GDPR 第 28 条数据处理协议的义务（Zero-DPA）。

---

3. 代码库不变量审计 CLI（ztds-audit）

无需安装，即可对代码库或 AI Agent 仓库运行安全性和不变量审计：

npx ztds-audit --dir ./src --strict

命令行标志

标志	描述	默认值
-d, --dir <path>	要审计的目标目录	当前工作目录
--json	输出结构化、机器可读的 JSON 报告	false
--strict	发现任何低严重性或信息性问题时，构建失败	false
-h, --help	显示 CLI 选项和用法	不适用

示例输出

[ZTDS] ZTDS.ai In-Memory Codebase Auditor (RFC v1.0 Conformance)
----------------------------------------------------------------------
Directory:     /home/runner/work/ai-agent/src
Files Scanned: 48 files in 18ms
Audit Hash:    sha256:7f83b1657ff1fc53b92dc18148a1d65dfc2d4b1fa3d677284addd200126d9069
----------------------------------------------------------------------

[PASS] CONFORMANCE CONFIRMED: 0 INVARIANT VIOLATIONS DETECTED
All scanned files comply with ZTDS Invariant 1 (Zero-Egress) and Invariant 3 (RAM isolation).

[LEGAL STATUS] Qualifies for GDPR Article 28 DPA Exemption (Zero-Subprocessor Chain)
[PERFORMANCE]  0.00 Bytes Sensitive WAN Egress | Pure In-Memory Execution

Next Steps for Builders & Maintainers:
1. Include this audit hash in your pull request: https://ztds.ai/apply/
2. Embed your Verified Trust Badge in README.md to claim your registry backlink:
   [![ZTDS Verified](https://ztds.ai/badge/your-app.svg)](https://ztds.ai/registry/)

---

4. GitHub Actions CI/CD 集成

创建 .github/workflows/ztds-audit.yml，在每个拉取请求中强制执行零信任数据清理：

name: ZTDS Zero-Trust Compliance Audit

on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]

jobs:
  audit:
    name: Verify ZTDS RFC v1.0 Invariants
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Codebase
        uses: actions/checkout@v4

      - name: Setup Node.js Runtime
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Execute ZTDS Invariant Audit
        uses: moxno/ztds.ai@main
        with:
          dir: './src'
          strict: true

---

5. 实证 AI 安全基准测试（前沿大模型）

验证 OpenAI GPT-4o、Anthropic Claude 3.5 Sonnet、Google Gemini 2.0 Pro 和 DeepSeek-V3 的明文泄漏防护、双射保真度和微秒级延迟：

# Execute 25 multi-domain enterprise scenarios across 4 frontier LLM families
npx ztds-bench

# Generate formal Markdown evaluation report & Ed25519 cryptographic certificate
npx ztds-bench --out-report benchmark-report.md --cert

前沿模型	原始外发（无 ZTDS）	受保护的外发（ZTDS）	泄漏防护率	双射保真度
openai/gpt-4o	100.0%	0.00%	100.0%	100.0%
anthropic/claude-3-5-sonnet	100.0%	0.00%	100.0%	100.0%
google/gemini-2.0-pro	100.0%	0.00%	100.0%	100.0%
deepseek/deepseek-v3	100.0%	0.00%	100.0%	100.0%

完整报告：ZTDS AI 安全基准测试报告（2026）

---

6. 修复与认证实现引擎

层级	软件包	许可证	角色与部署
开放参考核心	@ztds/core (packages/ztds-core)	Apache-2.0	与供应商无关的内存 TypeScript/JS 基准实现。通用正则规则（Email、Phone、PAN、SSN、API Keys）。文档
开放参考 MCP	ztds-mcp (packages/ztds-mcp)	Apache-2.0	官方零依赖参考 MCP 服务（Anthropic Registry 中的 io.github.moxno/ztds），适用于 Cursor、Claude Desktop 和 Zed。MCP 指南
认证先驱 SDK	@privacyscrubber/sdk	商业版 / 隔离网络	高吞吐量 WASM 引擎，具备 30 个专业行业配置文件（HIPAA、PCI-DSS、法律 FRE-502）、多线程管线绑定和离线 Ed25519 节点许可。获取 SDK
隔离网络 IDE MCP	@privacyscrubber/mcp-server	商业版 / Stdio	Stdio MCP 代理（io.github.moxno/privacyscrubber-mcp），适用于 Cursor、Windsurf、Claude Code、自主开发 Agent，并提供 30 个企业级配置文件。MCP 指南

---

7. 生态界定与中立性

• ZTDS.ai (ztds.ai)：独立、与供应商无关的开放标准、认证机构和技术联盟。依照 Apache 2.0 / CC BY 4.0 管理 RFC v1.0 规范。
• PrivacyScrubber (privacyscrubber.com)：商业参考实现及先驱引擎提供方。

---

8. 知识产权与法定治理

• 专利申请：美国及国际专利申请中（客户端零信任数据清理与加密多方管线交接系统和方法）。《巴黎公约》与 35 U.S.C. § 119 优先权 ()。
• 注册商标：ZTDS™（ILPO Order #182655957，类别 9 和 42）。
• 学术 DOI：
  • Zenodo：10.5281/zenodo.22058770
  • Open Science Framework (OSF)：10.17605/OSF.IO/5BYJF
  • SSRN：7335581
• 作者与创始人：Ilya Sibiryakov (BrandMeWeb)

---

9. 许可证

依据 Apache License, Version 2.0 授权。 版权所有 2024–2026 Ilya Sibiryakov (ZTDS AI Consortium / BrandMeWeb)。