vtimestamp mcp
用于验证和查询的MCP服务器 vtimestamp Verus区块链上的证明。
使AI代理（Claude Desktop、VS Code等）能够直接从区块链验证文档时间戳，并在VerusID上列出所有时间戳。
您在寻找写服务器吗？ 看 vtimestamp mcp写入 --需要一个本地守护进程和一个带有身份私钥的钱包。
安装
克劳德代码
claude mcp add --transport stdio --scope user vtimestamp-read -- npx vtimestamp-mcp@latest克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"vtimestamp": {
"command": "npx",
"args": ["-y", "vtimestamp-mcp@latest"]
}
}
}使用纱线：
{
"mcpServers": {
"vtimestamp": {
"command": "yarn",
"args": ["dlx", "vtimestamp-mcp"]
}
}
}使用pnpm：
{
"mcpServers": {
"vtimestamp": {
"command": "pnpm",
"args": ["dlx", "vtimestamp-mcp"]
}
}
}VS Code
添加到您的VS Code MCP设置中：
{
"mcp": {
"servers": {
"vtimestamp": {
"command": "npx",
"args": ["-y", "vtimestamp-mcp@latest"]
}
}
}
}工具
vtimestamp_verify
验证文件或文本是否已在VerusID上加盖时间戳。提供文件路径或文本——服务器计算SHA-256哈希值，并将其与链上记录进行核对。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
identity | string | Yes | VerusID名称（例如。， alice@) |
file_path | string | 其中之一 | 要验证的文件路径 |
text | string | 其中之一 | 要验证的文本字符串 |
要么 file_path 或 text 必须提供（互斥）。
示例提示：
- “检查/path/to/report.pdf处的文件是否已在alice@上打上时间戳”
- “验证此文本是否已在bob@上加盖时间戳：我证明4521号发票已获批准”
vtimestamp_list
列出VerusID上记录的所有时间戳。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
identity | string | Yes | VerusID名称（例如。， alice@) |
例子： “哪些文件有alice@timestamp？”
vtimestamp_info
获取有关vtimestamp服务的信息。
没有参数。
例子： “什么是vtimestamp？”
运作原理
默认情况下，服务器查询公共Verus主网RPC端点。无需钱包，无需API密钥，无需身份验证。
AI Agent (Claude Desktop, VS Code, etc.)
│ stdio (JSON-RPC)
▼
vtimestamp-mcp (local)
│ HTTPS (JSON-RPC 1.0)
▼
Public Verus Mainnet RPC (rpc.vrsc.syncproof.net, fallback api.verus.services)您还可以将此服务器指向您自己的守护进程，这对测试网（没有公共RPC支持解密）、高容量代理、自定义链或任何不希望检查碰到公共RPC的人都很有用。看 配置 在......下面
链上存储形态
vtimestamp存储在VerusID下 contentmultimap 并通过阅读 getidentityhistory （每个历史条目一个 updateidentity).此服务器透明地处理两个链上形状：
- 公共加密(
flags: 13，作者vtimestamp-mcp-write@1.2.0+) --守护进程的{data:{}}信封生成一个密文DataDescriptorepk和ivk发表在链上。阅读这些需要decryptdata+原始txid+retrieve: true因为IVK是链上的（公共加密模式），任何人都可以解密——没有密钥共享。 - 传统明文(
flags: 0，作者vtimestamp-mcp-write@1.1.x更早） --标签键下的每个字段数据描述符（sha256、标题、描述、文件名、文件大小）。直接阅读，无需decryptdata.
阅读器在每个条目的标志上分支。混合身份（来自旧写入的遗留条目和新的加密条目）得到了正确处理——两者都出现在 vtimestamp_list 输出。
有关背景信息，请参见 如何在身份上发布加密数据.
公共RPC要求
decryptdata 是一个守护进程RPC方法，公共Verus RPC不会全部列入白名单。截至撰写之时：
| 端点 | 链 | decryptdata | 注意事项 |
|---|---|---|---|
https://rpc.vrsc.syncproof.net | VRSC主网 | ✅ 已启用 | 此服务器的主终结点。 |
https://api.verus.services | VRSC主网 | ❌ disabled | 仅回退。加密条目在此处无法解密，但传统明文读取仍然有效 |
https://api.verustest.net | VRSCTEST | ❌ disabled | 不支持公共测试网RPC decryptdata. 测试网加密读取需要一个本地守护进程。 |
如果无法访问syncproof并且呼叫回退到 api.verus.services，加密条目将优雅地显示为不可解密，而不是崩溃。
配置
对于默认的公共RPC使用， 不需要配置。要将服务器指向您自己的守护进程（测试网需要，建议大量使用），请设置环境变量。
环境变量
全部可选。设置其中任何一个都会将服务器从公共RPC模式切换到本地守护进程模式。
| 变量 | 描述 |
|---|---|
VERUS_RPC_URL | 守护进程RPC URL（例如。， http://127.0.0.1:27486 对于主网， http://127.0.0.1:18843 用于测试网） |
VERUS_CONF_PATH | 通往a的道路 VRSC.conf / vrsctest.conf 文件。自动导出URL(http://127.0.0.1:)以及证书。 |
VERUS_RPC_USER | 覆盖：RPC用户名 |
VERUS_RPC_PASSWORD | 覆盖：RPC密码 |
行为：
- *（无环境变量）* → 公共RPC对(
rpc.vrsc.syncproof.net主要的，重要的api.verus.services回退）。仅限主网。 VERUS_RPC_URLset → 该URL上的单个本地端点。从进行身份验证VERUS_RPC_USER+VERUS_RPC_PASSWORD，或自动衍生自VERUS_CONF_PATH如果它们不见了。VERUS_CONF_PATH设置（无VERUS_RPC_URL) → URL =http://127.0.0.1:使用conf中的凭据。
本地守护程序示例（testnet）
{
"mcpServers": {
"vtimestamp": {
"command": "npx",
"args": ["-y", "vtimestamp-mcp@latest"],
"env": {
"VERUS_CONF_PATH": "/Users/you/Library/Application Support/Komodo/vrsctest/vrsctest.conf"
}
}
}
}或者明确地固定所有内容：
{
"mcpServers": {
"vtimestamp": {
"command": "npx",
"args": ["-y", "vtimestamp-mcp@latest"],
"env": {
"VERUS_RPC_URL": "http://127.0.0.1:18843",
"VERUS_RPC_USER": "rpc-user-from-conf",
"VERUS_RPC_PASSWORD": "rpc-password-from-conf"
}
}
}
}需求
- Node.js 18+
- 对于默认操作：没有别的——使用公共主网RPC。
- 对于测试网或本地守护进程模式：运行
verusd（或verusd -chain=vrsctest)在你指向的主机上。
许可证
麻省理工学院