WebCrypt MCP Server

WebCrypt v1.0.1

最新の JavaScript 向け、依存関係ゼロの Web Crypto とネイティブ AI エージェントツール（MCP）。

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 エージェントと 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 エージェントに WebCrypt MCP が必要な理由

自律型コーディングエージェントのツールベルトに、認証済みの暗号化ボールトを直接備えましょう。

• 🔐 機密情報のローカル保管（encrypt_payload）：API キーや状態メモリをディスクに書き込む前に暗号化し、プロンプトログへの漏えいを防ぎます。
• 🛡️ 改ざん防止の来歴証明（sign_verify）：ECDSA または HMAC で、テスト証拠パック、リリースバイナリ、コード差分に暗号署名します。
• 🤝 エージェント間の鍵交換（manage_keys）：一時的な JWK 鍵ペア（RSA-4096、ECDH P-256/P-384）を使って、エージェント間のプライベートメッセージングを実現します。
• ⚛️ ポスト量子の保護策（pqc_kem_sign）：組み込みの Kyber KEM と Dilithium 署名により、長期的に保管するエージェントの成果物を将来の脅威から守ります。
• ⚡ 依存関係ゼロ：Node.js 18 以降、Bun、ブラウザー、Edge ランタイムで、ネイティブの crypto.subtle を 100% 使用して実行します。

┌───────────────────────────────────────────────────────────┐
│              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	16 進数または 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 プロトコルとチャンクフレーミングの仕様。
🤖 エージェントスキルの定義	自動テストランナースクリプト付きのカスタムエージェントスキル。
📋 プロジェクト指示テンプレート	複数エージェント向けルールのテンプレート（``）。
💡 コード例ディレクトリ	すぐに実行できる Node.js とブラウザー向けのレシピ。

---

🌐 PuterVision Triad Standard

• 📊 @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）はそれぞれの所有者に帰属し、互換性を示す目的に限って使用しています。