ncrypted

ncrypted

面向 AI Agent 的一次性端到端加密机密信息。

Agent 在本地加密密码、API 密钥或备注，并获得一个只能打开一次的链接。你可以将它分享给他人、通过电子邮件发送，或交给另一个 Agent；读取后，机密信息就会销毁。Agent 还可以向用户请求机密信息，并将其直接写入 Vercel 环境变量或 .env 文件，而模型永远不会看到该值。

每天前 3 条机密信息免费；此后每条需通过 Base 上的 x402 支付 0.005 USDC。读取、请求和发送均免费。

可与 Claude Code、Codex、Cursor、Gemini CLI、任何 MCP 客户端、Vercel AI SDK、LangChain 和 CrewAI 搭配使用（Coinbase AgentKit 支持正在审核中）。使用指南：https://ncrypted.ai/guides

https://ncrypted.ai/s/{id}#{key}
                                    └─ decryption key, never sent to the server

安装

你需要一个专用的低余额 Base 钱包，并在其中存入一些 USDC（无需 ETH）。将其私钥导出为 NCRYPTED_WALLET_PRIVATE_KEY。

Claude Code

/plugin marketplace add Seidl-Family/ncrypted
/plugin install ncrypted@ncrypted

任何 MCP 客户端（Claude Desktop、Cursor、Codex、……）

{ "mcpServers": { "ncrypted": { "command": "npx", "args": ["-y", "@seidl-family/ncrypted-mcp"], "env": { "NCRYPTED_WALLET_PRIVATE_KEY": "0x..." } } } }

Agent Skill：npx skills add Seidl-Family/ncrypted

CLI / SDK

echo "hunter2" | npx ncrypted create --ttl 1h [--email [email protected]] [--passphrase X]
npx ncrypted read "https://ncrypted.ai/s/abc#key"

import { Ncrypted } from "ncrypted";
const nc = new Ncrypted(); // reads NCRYPTED_WALLET_PRIVATE_KEY
const { link, receiptToken, id } = await nc.create("hunter2", { ttl: 3600 });
const value = await nc.read(link); // free, destroys it

工作原理

• 零知识：使用随机的 256 位密钥进行 AES-256-GCM 加密，通过 HKDF 派生（如果设置了密码短语，还会使用 PBKDF2）。服务器仅存储密文。
• 只能读取一次：读取使用 Redis GETDEL，因此并发读取者无法同时获取机密信息。未读取的机密信息会在 TTL 到期后失效（5 分钟至 7 天）。
• 预览安全：打开网页不会消耗机密信息；接收者必须点击 Reveal。
• 按条付费：采用 x402 exact 方案，以 Base 上的 USDC 支付，仅在机密信息存储后结算。SDK 不会支付超过每次请求 0.01 美元的费用。
• 电子邮件：创建者可以通过电子邮件发送一次链接。链接仅在该请求期间经过服务器，不会被存储。对于特别敏感的信息，请使用密码短语。

付款与安全

ncrypted 对每条创建的机密信息收取固定费用 0.005 USDC，通过 Base 上的 x402 支付。其他所有操作均免费：读取、状态检查和撤销。

• **范围有限：**插件唯一可以进行的付款，是为 ncrypted_create 支付 ncrypted 自身的费用。它没有用于发送任意金额、交易、兑换或向他人付款的工具。
• **硬性上限：**无论服务器要求支付多少，SDK 对单次请求的付款都不会超过 0.01 USDC。
• **专用钱包：**付款来自用户专门创建（npx ncrypted wallet new）并自行充值的低余额钱包。插件绝不会询问、读取或存储用户的主钱包；该技能还会告知 Agent，绝不能在聊天中索要私钥。
• **明确可见：**每笔费用都对应一次明确的 ncrypted_create 工具调用，不存在后台或周期性收费。
• **失败不收费：**仅在机密信息存储后，才通过 Coinbase 的 x402 facilitator 结算付款。
• **默认零知识：**本地 MCP 服务会在用户的机器上加密，因此服务仅存储密文。可选的托管端点（https://ncrypted.ai/mcp）会明确标注为服务端加密。

联系的数据和服务

该插件的 MCP 服务、命令行工具和技能仅联系以下服务：

服务	发送的内容	时机
ncrypted API（https://ncrypted.ai，Vercel + Upstash Redis）	密文、IV、盐、密码短语标志和 TTL。绝不会发送密钥、密码短语或明文。	创建、读取、检查状态或销毁密钥时
Coinbase x402 facilitator / Base network	已签名的 USDC 付款授权（付款方地址、金额、收款方）	创建密钥时（0.005 USDC）
Base public RPC（mainnet.base.org）	付款方钱包地址	检查 ncrypted_wallet / ncrypted wallet 余额时
Resend，通过 ncrypted API	收件人邮箱地址、分享链接（其中包含密钥）以及可选备注。仅中继一次，ncrypted 不会存储。	仅在用户要求通过邮件发送链接时

数据保留：密文会在首次读取、销毁或到期时删除（最长 7 天）。回执元数据会在到期 7 天后删除。无分析数据，无 Cookie。详情：隐私政策。

仓库结构

路径	内容
apps/web	Vercel 上的 Next.js 应用：API、查看器页面、llms.txt、openapi.json
packages/sdk	npm 上的 ncrypted：加密、客户端、命令行工具
packages/mcp	npm 上的 @seidl-family/ncrypted-mcp：stdio MCP 服务
skills/ncrypted	Agent 技能（SKILL.md）
plugins/ncrypted	Claude Code 插件；.claude-plugin/marketplace.json 中列出了该插件
server.json	MCP Registry 清单（由 .github/workflows/mcp-registry.yml 发布）

开发

npm install
npm test                       # crypto unit tests
cp apps/web/.env.example apps/web/.env.local   # set NCRYPTED_PAY_TO
npm run dev                    # in-memory store when Redis isn't configured
npm run build && npm run e2e   # needs .env.e2e with a funded Base Sepolia wallet

编辑 skills/ncrypted/SKILL.md 后，运行 npm run sync:skill。

工具选择评测：./scripts/run-evals.sh 会在插件的临时副本上运行 evals/（14 个用例、模拟 MCP 工具、约 $2.50）。更改工具描述或技能后请重新运行；工具有变动时，请从 tools/list 刷新 evals/mocks/ncrypted/_tools.json。

每次发布 MCP 时，更新 Dockerfile、plugins/ncrypted/.mcp.json、plugins/ncrypted/package.json 中锁定的版本（然后在该目录运行 npm install --package-lock-only），以及 gemini-extension.json 中的版本（Claude 目录不接受 @latest），然后运行 “Publish to MCP Registry” 工作流。