中文 | 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=<tool_name> 调用；其余参数放在 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 list

Cursor

如果你希望“跟随项目”共享 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": []
    }
  }
}

安全说明

• 本项目面向开发/研究用途；不要把“示例密钥/示例参数”直接用于生产环境。
• 涉及密钥生成/存储/分发的真实业务，应采用成熟的密钥管理与审计流程。