中文 | English
Pivot - Cryptography MCP Server
Pivot 是一个用 Rust 实现的 Model Context Protocol（MCP）Server，通过 MCP Tools 向你的 AI 客户端（例如 Claude Code / Cursor / TRAE 等）提供常用密码学能力，适用于开发、排障与安全研究场景。
名字由来：Pivot / 枢机
- 英文含义：Pivot 是“枢轴 / 中心点”
- 中文意象：枢机。语出《易经》：“言行，君子之枢机。” 指关键的机关或转轴，牵一发而动全身
- 寓意：非常贴合 MCP 的定位——它作为“中枢”，根据输入（Input）转动算法机关并输出结果；它不生产数据，而是数据流转与变形的关键控制点
这个项目做了什么
- 把常见密码学操作封装为 MCP Tools：编码/解码、哈希、MAC、KDF、对称/非对称加密、部分后量子算法等
- 支持两种暴露方式：
- 全量工具模式：每个算法/操作是一个独立 tool（例如 sha256、aes_256_gcm_encrypt） - 聚合工具模式：只暴露一个 crypto tool（适合“tool 数量有限制”的宿主），通过 operation 分发
- 输入/输出友好：自动识别
hex/base64/utf8输入前缀；输出可用output_format=hex|base64|utf8覆盖 - 工具自动注册：内部用 registry 收集算法实现并生成 MCP tool 列表
使用方式（面向 MCP 客户端）
前提：你本地有可执行文件 pivot，并且客户端支持 MCP 的 stdio transport。
1) 在你的 MCP 客户端里把 Pivot 注册为一个 MCP Server（见下方配置示例） 2) 重启客户端，让它加载新 server 3) 在对话里直接使用工具能力（客户端会自动调用 tools）
你可以这样提问（示例）：
- “把
Hello做sha256，输出 hex” - “用 AES-256-GCM 加密这段文本，key/iv 用 hex 前缀给你：…”
- “生成一对 Ed25519 密钥，并对这段内容签名”
输入格式约定
- Hex：
48656c6c6f或hex:48656c6c6f - Base64：
SGVsbG8=或base64:SGVsbG8= - UTF-8：
Hello或utf8:Hello
聚合工具模式（crypto）
如果你的客户端对 tool 数量有限制，可以使用“聚合工具模式”。此时 MCP 工具列表里只会出现 crypto：
- 用
operation=describe获取可用操作清单与参数要求 - 其他操作通过
operation=调用；其余参数放在args对象里（input单独提供）
常见 MCP 客户端配置
说明：不同客户端的“配置文件路径/配置入口”可能随版本变化。下面给出常见工具的配置片段/命令，你只需要把路径替换成你本机的 pivot 路径即可。
Claude Code（CLI）
使用 claude mcp 命令添加一个 stdio MCP Server（Pivot 就是 stdio 模式）：
claude mcp add pivot -- /ABSOLUTE/PATH/TO/pivot可选：添加为项目级配置（跟随仓库生效）：
claude mcp add --scope project pivot -- /ABSOLUTE/PATH/TO/pivot查看是否生效：
claude mcp listCursor
如果你希望“跟随项目”共享 MCP Server 配置，可以在仓库内放置一个项目配置文件（名称/位置以 Cursor 版本为准；下面用 .cursor/mcp.json 作为示例）：
./.cursor/mcp.json：
{
"mcpServers": {
"pivot": {
"command": "/ABSOLUTE/PATH/TO/pivot",
"args": []
}
}
}TRAE
TRAE 的配置也可以按同样思路添加一个 MCP Server（具体放置位置与字段名以 TRAE 文档为准；这里提供通用 mcpServers 结构示例）：
{
"mcpServers": {
"pivot": {
"command": "/ABSOLUTE/PATH/TO/pivot",
"args": []
}
}
}安全说明
- 本项目面向开发/研究用途；不要把“示例密钥/示例参数”直接用于生产环境。
- 涉及密钥生成/存储/分发的真实业务，应采用成熟的密钥管理与审计流程。