通过模型上下文协议 (Model Context Protocol) 为 AI 智能体提供加密审计追踪
Related MCP server: DCL Evaluator
PiQrypt MCP 服务器为 PiQrypt 提供模型上下文协议 (Model Context Protocol) 访问权限——这是面向 AI 智能体的后量子密码审计追踪系统。
使用场景：
🤖 AI 智能体：用加密证明签署每一项决策
📊 n8n 工作流：为自动化工作流添加审计追踪
🏦 交易机器人：满足自动化交易的 SEC/FINRA 合规性要求
👥 人力资源自动化：符合 GDPR 的 AI 招聘决策
🏥 医疗保健 AI：医疗决策的 HIPAA 审计追踪
1. 安装 piqrypt (必需 — Python 3.8+)
pip install piqryptMCP 服务器将所有加密操作委托给 piqrypt Python 包。如果未安装，服务器在每次调用工具时都会返回明确的错误。
2. 安装 MCP 服务器 (Node.js 18+)
npm install -g @piqrypt/mcp-servernpx @piqrypt/mcp-servergit clone https://github.com/piqrypt/piqrypt-mcp-server
cd piqrypt-mcp-server
npm install
npm run build默认情况下，服务器使用 python3 (Linux/Mac) 或 python (Windows)。如果 piqrypt 安装在虚拟环境中，请将此变量设置为指向正确的解释器：
Windows
set PIQRYPT_PYTHON=C:\path\to\venv\Scripts\python.exeLinux / Mac
export PIQRYPT_PYTHON=/path/to/venv/bin/python要使其持久化，请将其添加到您的 MCP 客户端配置中：
{
"mcpServers": {
"piqrypt": {
"command": "piqrypt-mcp-server",
"args": [],
"env": {
"PIQRYPT_PYTHON": "/path/to/venv/bin/python"
}
}
}
}添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"piqrypt": {
"command": "piqrypt-mcp-server",
"args": []
}
}
}安装 n8n MCP 集成
将 PiQrypt MCP 服务器添加到配置中
通过 MCP 节点在工作流中使用
客户端 | 版本 | 备注 |
任何兼容 MCP 的客户端 | MCP 规范 2024-11+ | stdio 传输 |
n8n | 1.88+ | 通过 MCP 节点 |
Cursor | 任意 | 添加到 mcp 设置 |
VS Code | 任意 | 添加到 mcp 设置 |
Continue | 任意 | 添加到 mcp 设置 |
Windsurf | 任意 | 添加到 mcp 设置 |
平台 | 集成 | 使用场景 |
n8n | MCP 节点 (原生) | 无代码审计追踪 |
Make.com | HTTP 模块 | Webhook 触发的标记 |
Zapier | Webhooks + HTTP | 基础事件记录 |
每个工具调用都经过相同的 4 个操作 — 标记、验证、导出、搜索。根据您的上下文，其实际意义如下：
自动化交易 / 金融 任何提交订单、重新平衡投资组合或触发交易的智能体都可以在执行前标记每项决策。签署的链条可导出以供 SEC/FINRA 审计，无需任何额外基础设施。
人力资源和招聘自动化 任何评估候选人、对简历评分或筛选申请人的工作流都可以标记每项决策。为 AI 辅助招聘提供符合 GDPR 第 22 条的审计追踪 — 谁在何时决定了什么，以及使用了什么数据（已哈希，从不存储原始数据）。
内容和发布流水线 任何起草、批准或发布内容的智能体都可以标记每个步骤。当多个 AI 智能体协作且您需要证明归属时非常有用 — 哪个智能体编写了什么，顺序如何。
DevOps 和 CI/CD 任何触发部署、合并分支或轮换密钥的智能体都可以标记每个操作。为自主智能体所做的基础设施变更提供防篡改记录。
医疗保健和医疗 AI 任何诊断或分诊智能体都可以标记每项建议。提供符合 HIPAA 的审计追踪，将每个 AI 输出链接到可验证的智能体身份。
所有情况下的通用模式：
[Agent makes decision]
↓
piqrypt_stamp_event ← sign + chain
↓
[Agent executes action]
↓
piqrypt_export_audit ← portable proof, verifiable
without PiQrypt installedpiqrypt_stamp_event用加密证明签署 AI 决策。
参数：
agent_id (字符串，必需)：智能体标识符
payload (对象，必需)：决策数据
previous_hash (字符串，可选)：用于链接的前一个事件哈希
示例：
const event = await mcp.call('piqrypt_stamp_event', {
agent_id: 'trading_bot_v1',
payload: {
action: 'buy',
symbol: 'AAPL',
quantity: 100,
price: 150.25
}
});返回：
{
"version": "AISS-1.0",
"agent_id": "trading_bot_v1",
"timestamp": 1739382400,
"nonce": "uuid-...",
"payload": { ... },
"previous_hash": "sha256:...",
"signature": "base64:..."
}piqrypt_verify_chain验证事件链的完整性。
参数：
events (数组，必需)：要验证的事件
示例：
const result = await mcp.call('piqrypt_verify_chain', {
events: [event1, event2, event3]
});返回：
{
"valid": true,
"events_count": 3,
"chain_hash": "sha256:...",
"errors": []
}piqrypt_export_audit导出审计追踪以供合规使用。
参数：
agent_id (字符串，必需)：要导出的智能体
certified (布尔值)：请求 PiQrypt 认证
output_format (字符串)：json 或 pqz
示例：
const audit = await mcp.call('piqrypt_export_audit', {
agent_id: 'trading_bot_v1',
certified: true,
output_format: 'json'
});piqrypt_search_events通过 SQLite 索引进行快速搜索。
参数：
event_type (字符串，可选)：按类型过滤
from_timestamp (数字，可选)：开始时间
to_timestamp (数字，可选)：结束时间
limit (数字)：最大结果数（默认：100）
示例：
const trades = await mcp.call('piqrypt_search_events', {
event_type: 'trade_executed',
from_timestamp: 1739300000,
limit: 50
});每个标记的事件都可以在 Vigil 中查看 — 这是 PiQrypt 的本地监控仪表板。
注意： Vigil 不会由 MCP 服务器自动启动。您必须在打开仪表板之前单独启动它。
piqrypt vigil
# → http://localhost:8421免费层级包括：链健康状况、VRS 风险评分、7 天历史记录、关键警报。升级到 Pro 可获得 90 天历史记录、TrustGate 治理和后量子签名。
智能体在首次标记时自动创建。要查看和删除智能体：
启动 Vigil：piqrypt vigil
进入 All Agents 视图
勾选要删除的智能体 → 点击 ✕ Delete selected
确认 — 当没有智能体剩余时，Vigil 会返回欢迎屏幕
智能体存储在您机器上的
~/.piqrypt/agents/中。删除智能体将永久移除其密钥和事件历史记录。
┌─────────────────────────────────────┐
│ MCP Client (any MCP-compatible client) │
│ ↓ JSON-RPC over stdio │
├─────────────────────────────────────┤
│ MCP Server (TypeScript/Node.js) │ ← No crypto here
│ ↓ subprocess call │
├─────────────────────────────────────┤
│ Python Bridge (bridge.py) │
│ ↓ invokes CLI │
├─────────────────────────────────────┤
│ PiQrypt CLI (Python) │
│ ↓ uses │
├─────────────────────────────────────┤
│ Core Crypto (aiss package) │ ← All crypto here
│ • Ed25519 / Dilithium3 │
│ • RFC 8785 canonical JSON │
│ • Hash chains │
└─────────────────────────────────────┘✅ 私钥从不暴露给 MCP 层 ✅ 所有加密都在 Python 中进行 (Ed25519, Dilithium3) ✅ 与 CLI 相同的安全性 (进程隔离) ✅ 符合 RFC AISS-1.1 标准 (输出一致) ✅ 子进程调用前的输入验证
[Webhook: price alert]
↓
[AI Decision: buy/sell?]
↓
[PiQrypt MCP: stamp decision] ← Audit trail
↓
[Execute trade API]
↓
[Database: store proof][Upload CV]
↓
[AI Agent: evaluate candidate]
↓
[PiQrypt MCP: stamp evaluation] ← GDPR compliance
↓
[Email HR team]# Build
npm run build
# Test bridge
python3 src/python/bridge.py stamp '{"agent_id":"test","payload":{"action":"test"}}'
# Test MCP server (manual)
node dist/index.js
# Then send MCP request via stdinError: piqrypt is not installed in this Python environmentMCP 服务器使用的 Python 解释器找不到 piqrypt 包。
修复：
pip install piqrypt如果 piqrypt 安装在虚拟环境中而不是系统 Python 中，请设置 PIQRYPT_PYTHON 指向正确的解释器：
# Linux / Mac
export PIQRYPT_PYTHON=/path/to/venv/bin/python
# Windows
set PIQRYPT_PYTHON=C:\path\to\venv\Scripts\python.exe要验证服务器将使用哪个 Python：
# Linux / Mac
$PIQRYPT_PYTHON -c "import aiss; print('ok')"
# Windows
%PIQRYPT_PYTHON% -c "import aiss; print('ok')"我们欢迎贡献！请参阅 CONTRIBUTING.md。
MCP 服务器 → MIT 许可证 - 请参阅 LICENSE PiQrypt 核心 → 免费层级 + 商业层级
PiQrypt 核心: https://github.com/piqrypt/piqrypt
MCP 协议: https://modelcontextprotocol.io
n8n: https://n8n.io
由 PiQrypt Inc. 用 ❤️ 构建
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Bitcoin-anchored, tamper-evident audit log for AI agents — record, disclose and verify actions.
Etch is a signed audit chain for AI agent decisions, offline-verifiable against pinned public keys.
Issue signed receipts for AI agent actions; verify any receipt offline - free, no account.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/PiQrypt/piqrypt-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server