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:
- 允许您的IP： 添加
rpcallowip=（默认情况下，守护进程只接受localhost） - 打开端口： 确保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参数可用于控制哪个地址支付费用
许可证
麻省理工学院