WebCrypt MCP Server

WebCrypt v1.0.1

零依赖 Web Crypto 与原生 AI Agent 工具（MCP），适用于现代 JavaScript。

AES-256-GCM 对称加密、RSA-4096 混合公钥、ECDH 密钥协商、ECDSA/HMAC 数字签名，以及后量子 KEM（Kyber/Dilithium）——零运行时依赖，纯 Web Crypto API。

---

⚡ 快速入门（15 秒）

1. 安装

# 📦 Install as project library (Node.js, TypeScript, Browser)
npm install webcrypt

# 🌐 Install globally (CLI utilities & global MCP tools)
npm install -g webcrypt

import { WebCrypt, WebCryptAsym } from "webcrypt";

// 🔒 Symmetric AES-256-GCM (600k PBKDF2 iterations)
const wc = new WebCrypt();
const encrypted = await wc.encryptText("Secret payload", "password");
const decrypted = await wc.decryptText(encrypted, "password");

// 🔑 Asymmetric RSA-4096 Hybrid Encryption
const wca = new WebCryptAsym();
const keyPair = await wca.generateKeyPair(4096);
const cipher = await wca.encryptText("Secret payload", keyPair.publicKey);
const plain = await wca.decryptText(cipher, keyPair.privateKey);

---

2. 为 AI Agent 和 IDE 自动配置（MCP 服务）

# Initialize MCP server, agent skills, and rules across your project
npx webcrypt init  # or `webcrypt init` if installed globally

支持 Google Antigravity、Cursor、Claude Desktop、VS Code / Copilot、Windsurf、Cline 和 Zed。

---

🤖 AI Agent 为什么需要 WebCrypt MCP

为自主编码 Agent 配备经过身份验证的加密保险库，直接集成到其工具集中：

• 🔐 机密本地存储（encrypt_payload）：在将 API 密钥和状态记忆写入磁盘前对其加密，防止提示词日志泄漏。
• 🛡️ 防篡改来源证明（sign_verify）：使用 ECDSA 或 HMAC 对测试证据包、发布二进制文件和代码差异进行加密签名。
• 🤝 Agent 间密钥交换（manage_keys）：使用临时 JWK 密钥对（RSA-4096、ECDH P-256/P-384）实现 Agent 间私密通信。
• ⚛️ 后量子防护措施（pqc_kem_sign）：内置 Kyber KEM 和 Dilithium 签名，为 Agent 的长期存档提供面向未来的保护。
• ⚡ 零依赖：在 Node.js 18+、Bun、浏览器和 Edge 运行时中 100% 使用原生 crypto.subtle 执行。

┌───────────────────────────────────────────────────────────┐
│              Autonomous AI Coding Agent                   │
│     (Antigravity / Cursor / Claude / Copilot / Cline)     │
└─────────┬───────────────────┬───────────────────┬─────────┘
          │                   │                   │
          ▼                   ▼                   ▼
┌───────────────────┐┌───────────────────┐┌───────────────────┐
│ state-memory-mcp  ││ vision-memory-mcp ││     webcrypt      │
│  (Workflow State) ││  (Visual Cache)   ││  (Security Vault) │
│  • Task Graph DAG ││  • UI Grounding   ││  • AES-256 Vault  │
│  • Decisions & SDD││  • Layout Trees   ││  • RSA/ECDH Keys  │
│  • Event Ledger   ││  • Visual History ││  • Digital Sigs   │
└───────────────────┘└───────────────────┘└───────────────────┘

---

🛠️ MCP 工具参考（6 个核心工具）

工具	操作 / 模式	说明
encrypt_payload	symmetric | asymmetric | data	使用 AES-256-GCM 或 RSA-4096 加密文本、JSON 对象或文件。
decrypt_payload	symmetric | asymmetric | data	将密文解密为明文或结构化 JSON。
manage_keys	generate | generate_random_password	生成 JWK 密钥对（RSA、ECDH、ECDSA、RSA-PSS）或高熵密码。
crypto_hash	SHA-256 | SHA-512 | SHA-3	以十六进制或 base64 格式计算加密哈希摘要。
sign_verify	sign | verify	对消息、发布哈希和证据包进行签名与验证。
pqc_kem_sign	kyber_* | dilithium_* | hybrid_*	后量子 Kyber KEM 封装和 Dilithium 签名。

---

📚 技术文档目录

在 docs/ 和 examples/ 中查看专门的指南：

指南	主题
🚀 实时交互式体验区	在浏览器演示中测试所有加密功能。
💻 CLI 参考指南	项目脚手架、全局项目扫描和终端实用工具。
⚙️ 多 IDE MCP 配置指南	为所有主流 IDE 提供分步 MCP JSON 配置。
🔒 对称加密 API（WebCrypt）	AES-256-GCM、流式文件、WebRTC E2EE、PBKDF2。
🔑 非对称加密 API（WebCryptAsym）	RSA-4096 混合加密、ECDH 密钥协商、ECDSA/RSA-PSS。
⚛️ 后量子密码学指南	Kyber KEM、Dilithium 签名和混合 KEM。
🏗️ 架构与 MCP 规范	Stdio JSON-RPC 2.0 协议和分块帧规范。
🤖 Agent 技能定义	自定义 Agent 技能，配有自动化测试运行脚本。
📋 项目说明模板	多 Agent 规则模板（``）。
💡 代码示例目录	可直接运行的 Node.js 和浏览器示例。

---

🌐 PuterVision 三位一体标准

• 📊 @putervision/state-memory-mcp：用于工作流状态、任务 DAG 和决策轨迹的持久化 SQLite 图。
• 👁️ @putervision/vision-memory-mcp：多模态视觉布局缓存、AX 定位和视频回放分析。
• 🔐 webcrypt：零依赖加密保险库、载荷加密、密钥管理和数字签名。

---

🧪 测试与诊断

# Run unit & integration test matrix (30 suites, 247 tests)
npm test

# Run live MCP tool test runner (25 assertions, 100% verified)
node .agents/skills/webcrypt-mcp/scripts/exercise_tools.js

# Audit environment & project configuration health
webcrypt doctor

---

⚖️ 许可证与免责声明

由 PuterVision 开发和维护。根据 MIT License 发布。

• 100% 本地执行保证：所有加密操作均通过标准 W3C Web Crypto API（crypto.subtle）在本地内存中执行。不会调用外部 API、收集遥测数据或传输网络数据。
• 商标与非关联声明：产品名称（Cursor、Claude、Google Antigravity、VS Code、GitHub Copilot、Windsurf、Cline、Zed）归其各自所有者所有，仅用于标识兼容性。