AI导哈

区块链时间戳服务

用于在Verus区块链上创建时间戳证明的MCP服务器，支持AI代理和开发工具直接写入区块链。

  • by vdappdev2
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 vdappdev2/vtimestamp-mcp-write

使用说明

vtimestamp mcp写入

MCP服务器 创建 vtimestamp Verus区块链上的证明。

使AI代理（Claude Desktop、VS Code等）能够在VerusID上创建文档时间戳——通过本地或远程守护进程直接写入Verus区块链。

正在查找只读服务器？ 看 vtimestamp mcp --不需要守护进程或钱包。

先决条件

  • Node.js 18+
  • Verus守护进程(verusd) 运行方式：
    • 身份的私钥导入钱包
    • 启用RPC访问（本地主机上的默认设置）

安装

克劳德代码

claude mcp add --transport stdio --scope user vtimestamp-write -- npx vtimestamp-mcp-write@latest

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "vtimestamp-write": {
      "command": "npx",
      "args": ["-y", "vtimestamp-mcp-write@latest"]
    }
  }
}

就是这样——服务器会自动检测您的RPC凭据 VRSC.conf （参见 配置 在......下面

VS Code

添加到您的VS Code MCP设置中：

{
  "mcp": {
    "servers": {
      "vtimestamp-write": {
        "command": "npx",
        "args": ["-y", "vtimestamp-mcp-write@latest"]
      }
    }
  }
}

配置

服务器会自动从您的本地读取RPC凭据 VRSC.conf 文件。大多数用户不需要手动配置。

自动检测 VRSC.conf 路径：

  • macOS： ~/Library/Application Support/Komodo/VRSC/VRSC.conf
  • Linux： ~/.komodo/VRSC/VRSC.conf
  • 窗户： %AppData%\Roaming\Komodo\VRSC\VRSC.conf

环境变量

所有选项都是可选的，仅适用于非标准设置或远程守护进程。

变量 描述
VERUS_CONF_PATH 自定义路径 VRSC.conf
VERUS_RPC_URL 覆盖：守护进程RPC URL（用于远程守护进程）
VERUS_RPC_USER 覆盖：RPC用户名（用于远程守护进程）
VERUS_RPC_PASSWORD 覆盖：RPC密码（用于远程守护进程）

工具

vtimestamp_create

在VerusID上创建新的时间戳。提供文件路径或文本——服务器会自动计算SHA-256哈希值。

参数 类型 必填 说明
identity string Yes VerusID名称（例如。， alice@)
file_path string 其中之一 要哈希和时间戳的文件路径
text string 其中之一 用于哈希和时间戳的文本（例如，证明或报告）
title string 是 时间戳的标题
description string 否 内容描述
filename string 否 原始文件名（使用时自动检测 file_path)
filesize number 否 文件大小（以字节为单位）（使用时自动检测 file_path)
sourceoffunds string 否 资金地址（R-地址、z-地址或ID@）
feeoffer number No VRSC中的费用优惠（默认值：0.0001）

要么 file_path 或 text 必须提供（互斥）。

示例提示：

  • “在alice@上的/path/to/report.pdf处为文件添加时间戳”
  • “在alice@上标记此文本的时间戳：我证明4521号发票已获批准”

成功响应：

{
  "success": true,
  "identity": "alice@",
  "hash": "a7f3b2c1...",
  "title": "Q4 Report",
  "transaction_id": "abc123...",
  "message": "Timestamp created successfully"
}

错误案例：

  • 未找到标识→ 标识名错误
  • 重复哈希→ 现有块高度和txid错误
  • 文件未找到→ InvalidParams 错误
  • RPC失败→ 守护程序消息出错

运作原理

服务器连接到您的Verus守护进程（本地或远程）以创建链上时间戳。守护进程的钱包中必须有身份的私钥才能对 updateidentity 交易。

AI Agent (Claude Desktop, VS Code, etc.)
    │ stdio (JSON-RPC)
    ▼
vtimestamp-mcp-write (local)
    │ HTTP (JSON-RPC 1.0, with auth)
    ▼
Your Verus Daemon (verusd)
    ├── Has identity's private key in wallet
    ├── Signs and broadcasts updateidentity tx
    └── Local (127.0.0.1) or remote (VPS)

链上存储形态

截至 v1.2.0版本，此服务器将时间戳写入为 公共加密 VerusID下的条目 contentmultimap每个时间戳在 proof.basic 外钥匙(iJvkQ3uTKmRoFiE3rtP8YJxryLBKu8enmX)使用守护进程 {data: {...}} 信封速记。守护进程将其扩展为链上DataDescriptor flags: 13 （HAS_OBJECTDATA|加密|HAS_IVK）-密文 objectdata，加上已发布 epk 和 ivk 领域。

元数据（sha256、标题、描述、文件名、文件大小）在加密之前被JSON字符串化为单个消息，因此一次解密调用可以恢复所有字段。因为IVK是在链上发布的（公共加密模式）， 任何人 可以解密这些条目——读者不需要密钥共享或钱包访问。看 vtimestamp mcp 对于阅读方面。

这对检查意味着什么：

  • 通过任何读取的RPC检查cmm(getidentity, getidentityhistory, getidentitycontent)返回密文描述符，而不是可读字符串。
  • 恢复原始字段需要 decryptdata 传递描述符+发起txid的调用+ retrieve: true守护进程将密文存储为对写入事务的间接引用——txid是解密输入的一部分。
  • 根据身份验证哈希值不需要钱包，只需要守护进程RPC访问具有以下功能的节点 decryptdata 白名单。

旧条目继续工作。 由以下人员写入的时间戳 1.1.x 以及更早的版本（每个字段的明文数据描述符 flags: 0)永远保持在链上（cmm仅附加），以及 vtimestamp-mcp@1.2.0+ 透明地读取这两个形状。

有关背景信息，请参见 如何在身份上发布加密数据.

守护程序设置

本地守护进程

最简单的设置-- verusd 与MCP服务器在同一台机器上运行。无需配置--从中自动检测凭据 VRSC.conf.

远程守护进程（VPS）

您可以将MCP服务器指向 verusd 在另一台机器（例如VPS）上运行的实例。守护进程需要在其 VRSC.conf:

  1. 允许您的IP： 添加 rpcallowip=<your-ip> （默认情况下，守护进程只接受localhost）
  2. 打开端口： 确保RPC端口（27486）可以通过任何防火墙访问

然后设置环境变量覆盖(VERUS_RPC_URL, VERUS_RPC_USER, VERUS_RPC_PASSWORD)在您的MCP配置中。

重要提示： RPC凭据通过纯HTTP发送。如果通过开放的互联网（而不是本地网络）连接，请使用SSH隧道来保护连接：

ssh -L 27486:127.0.0.1:27486 user@your-vps

然后使用 VERUS_RPC_URL=http://127.0.0.1:27486 就好像它是本地的——其余的都由隧道来处理。

安全说明

  • 此服务器 阅读你的 VRSC.conf 自动检测RPC凭据——没有秘密被复制或存储在其他地方
  • 此服务器执行 链上写入 这需要支付少量交易费（默认为0.0001 VRSC）
  • 服务器只连接到您的本地守护进程（或您配置的URL），不会将数据发送到其他地方
  • 如果连接到远程守护进程，请使用SSH隧道，而不是直接暴露RPC端口
  • 这 sourceoffunds 参数可用于控制哪个地址支付费用

许可证

麻省理工学院

相关 MCP