SignaTrust

@signatrust/mcp-server

从 Claude 发送并验证电子签名——零托管，每个签名都附有可独立验证的加密证据。

SignaTrust 文档签名 API 的 Model Context Protocol (MCP) 服务。支持 Claude 等 AI 助手通过自然语言创建信封、管理模板、查看签署状态并验证区块链锚定记录。

快速开始

Claude Code

claude mcp add signatrust -- npx -y @signatrust/mcp-server

然后在 MCP 服务环境中设置你的 API 密钥。

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": {
        "SIGNATRUST_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级）：

{
  "mcpServers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": {
        "SIGNATRUST_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json（注意：顶层键是 servers，而不是 mcpServers）：

{
  "servers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": {
        "SIGNATRUST_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

若要避免将密钥写入文件，请使用输入提示，而不是 env：

{
  "inputs": [
    { "id": "signatrust-key", "type": "promptString", "description": "SignaTrust API key", "password": true }
  ],
  "servers": {
    "signatrust": {
      "command": "npx",
      "args": ["-y", "@signatrust/mcp-server"],
      "env": { "SIGNATRUST_API_KEY": "${input:signatrust-key}" }
    }
  }
}

可用工具

工具	描述	所需权限范围
list_envelopes	按状态筛选并分页列出信封	envelopes:read
get_envelope	获取完整的信封详情（签署者、文档、区块链）	envelopes:read
create_envelope	创建信封并发送以供签署。接受 documentIds（在使用 upload_document 上传后）或 templateId（后端会复制该模板）。支持三级 securityLevel。	envelopes:write
list_templates	列出可用的文档模板	templates:read
upload_document	读取本地文件并上传至 SignaTrust，返回供 create_envelope 使用的文档 ID	documents:write
download_document	获取有时限的预签名 URL，用于下载文档（例如已签署的 PDF）	documents:read
analyze_document	对信封进行 AI 合同分析（由 Gemini 驱动的风险／情感审查，受套餐限制）	ai:analyze
verify_blockchain	验证 Solana 锚定记录并返回组合哈希、文件哈希及浏览器 URL	envelopes:read
get_evidence	获取完整的、可用于法庭的证据包（信封、签署者、审计跟踪、区块链验证）	envelopes:read

三级安全性。 create_envelope 接受 securityLevel：STANDARD（仅限持有者令牌）、VERIFIED（增加短信／电子邮件 OTP——推荐用于就业、供应商或医疗保健同意书），或 CERTIFIED（增加 WebAuthn 生物识别验证和设备绑定——推荐用于房地产、高价值或受监管的签署）。

API 密钥权限范围

在 SignaTrust 控制面板的 Settings > API Keys 中创建 API 密钥。根据所需工具分配权限范围：

权限范围	启用的工具
envelopes:read	list_envelopes、get_envelope、verify_blockchain、get_evidence
envelopes:write	create_envelope
templates:read	list_templates
documents:write	upload_document
documents:read	download_document
ai:analyze	analyze_document

环境变量

变量	必需	默认值	描述
SIGNATRUST_API_KEY	是	-	以 sk_live_ 开头的 API 密钥
SIGNATRUST_API_URL	否	https://app.signatrust.io	API 基础 URL

自然语言示例

连接后，你可以向 AI 助手提出以下请求：

• “列出我所有待处理的信封”
• “上传 ~/Documents/nda.pdf，并使用 VERIFIED 安全级别发送给 [email protected]”
• “显示可用模板，然后使用住宅模板为 John Doe 创建一份租赁协议”
• “检查信封 env_abc123 的区块链验证，并显示复合哈希”
• “对信封 env_xyz 运行 AI 分析——我想知道签署人审阅前是否存在任何风险条款”

开发

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Type check
npm run typecheck

# Local smoke test
SIGNATRUST_API_KEY=sk_live_xxx SIGNATRUST_API_URL=http://localhost:3000 node dist/server.js

架构

src/
  server.ts                      # Entry point — env validation, MCP server setup, stdio transport
  handlers.ts                    # Tool definitions and handler dispatch (testable)
  errors.ts                      # RFC 7807 ProblemDetails -> MCP tool error mapping
  vendor/signatrust-sdk/         # Vendored HTTP client + types (zero external runtime deps)
  *.test.ts                      # Co-located test files

HTTP 客户端和 API 类型随包一同存放于 src/vendor/signatrust-sdk/ 下，因此除了 @modelcontextprotocol/sdk 外，本包没有其他外部运行时依赖。