attest-mcp-remote

attest-mcp-remote

已列入官方 MCP Registry，登记名为 io.github.SPAZIO-GENESI/attest-mcp-remote。

适用于 Spazio Genesi digital-work attestation service 的远程 MCP 服务（Streamable HTTP）。无需安装： 在 MCP 客户端中将 URL 添加为连接器，即可开始验证和存证。

有意确保文件绝不传输。 MCP 没有可靠的客户端→服务端文件传输通道，而此服务也不需要这样的通道：每个工具都基于作品的 SHA-256 指纹运行。具备代码执行能力的 Agent 会在本地计算指纹 （sha256sum <file>），因此文件绝不会离开其所在设备——甚至不会经由此服务传输。如需处理本地文件的工具，请使用 stdio 包 @spazio-genesi/attest-mcp； 人工用户可使用网站（在浏览器中计算哈希，充分保护隐私）或 Telegram 机器人 @SGAttestBot。

状态

已投入生产。 服务运行于 https://attest-mcp-remote.it-e3f.workers.dev/mcp。 全部 8 个工具均已实现、测试，并通过生产环境端到端验证，其中包括在 claude.ai 上实际完成的一次零安装操作（通过 URL 添加连接器，经人工 Turnstile 审批，签发并归档证书 PDF）。

工具

工具	身份验证	功能
service_status	无	检查 Worker / 归档服务 / 签名服务 / Bitcoin 锚定状态
check_anchor	无	查询指纹的 OpenTimestamps 证明
verify_attestation	无	验证存证的服务器 HMAC 签名
lookup_certificate	无	查询指纹的归档记录和永久链接
authorize	启动设备授权流程	用户在浏览器中审批一次（反机器人检查）
complete_authorization	设备授权流程	获取 24 小时会话令牌（保存在会话状态中，绝不回显）
attest_hash	会话令牌或 API 密钥标头	将指纹绑定到带服务器签名的时间戳
create_certificate_pdf	会话级	生成并归档证书 PDF，返回永久链接

凭据：可以使用上述零配置设备授权流程，也可以在连接中添加 Authorization: Bearer sg_k_… 标头（例如 Claude Code： claude mcp add --transport http attest <url> --header "Authorization: Bearer sg_k_…"）。 自助申请密钥：https://imgauth.spaziogenesi.org/developer/keys

开发

npm install
npm run dev            # wrangler dev (default port 8787)
node test/smoke.mjs http://127.0.0.1:8787

test/smoke.mjs 针对真实的公开生产数据（只读），对 Streamable HTTP 传输执行端到端测试（initialize → tools/list → tools/call）。 test/smoke-auth.mjs 覆盖凭据验证流程，是一个仅供本地使用的测试工具：它需要隔离运行的 imgauth wrangler dev（使用独立的 --persist-to 状态，并清空 SIGNER_URL），因为用户审批步骤是通过直接写入本地 D1 来模拟的——详见文件开头的注释。

⚠️ 提升版本号时

此服务还通过 Web 界面发布的 MCP Server Card 进行展示，其中重复列出了此服务的名称、版本和端点：

https://attestazione.spaziogenesi.org/.well-known/mcp/server-card.json
→ 文件：imgauthweb/.well-known/mcp/server-card.json

此文件不会根据此仓库生成，因此在此处提升版本号会导致内容悄然过时。更改 package.json 和 server.json 中的 version 时，也要更新卡片中的 serverInfo.version——确保属于同一版本发布，并在同一天完成。（发布一张版本号错误的卡片，与将过时的 openapi.json 留在项目中属于同一类问题：会提供错误信息的描述文件，还不如没有。）

安全

报告漏洞 → /sicurezza/ （负责任披露政策，为善意研究提供安全港）——此仓库没有自己的 security.txt（这是一个没有静态资源的 Worker），但该政策适用于整个项目，包括此 workers.dev 服务。

许可证

MIT — © Spazio Genesi ETS。这是公共 imgauth API 的纯客户端，不定义自身的 API 契约。