内容
# 时钟链开发者工具
一个 **命令行界面（CLI）** 和 **MCP服务器** ，为任意 **MCP客户端** （Claude Code、Cursor、Claude Desktop、Codex、Hermes、OpenClaw等）和终端添加时钟链的工具——**共识时间、 notarization、智能合约调度、审计轨迹和代理身份验证**。它封装了位于 `node.clockchain.network` 的实时D4节点网关；它 **不** 改变区块链协议。
> **在您的MCP客户端中安装：** [`INSTALL.md`](INSTALL.md) —托管端点（任意客户端，推荐）或自托管（本地stdio）。
> **非工程师？尝试在~10分钟内：** [`TRY-IT.md`](TRY-IT.md) · **工程师：** [`QUICKSTART.md`](QUICKSTART.md)
> **路线图 + 当前限制：** [`roadmap.md`](roadmap.md)
## 快速安装 — 托管端点（任意MCP客户端）
与 **任意MCP客户端** 配合使用 — Claude Code、Cursor、Claude Desktop、Codex、 Hermes、OpenClaw。立即获取测试网 **令牌** (`x-api-key`) — `curl -X POST https://mcp.clockchain.network/token`（无需注册）— 然后将其添加到客户端的MCP配置中：
```json
{
"mcpServers": {
"clockchain": {
"type": "http",
"url": "https://mcp.clockchain.network/mcp",
"headers": { "x-api-key": "<YOUR_TOKEN>" }
}
}
}
```
带有 `mcp add` 命令的CLI（以Claude Code为例）：
```bash
claude mcp add clockchain --transport http https://mcp.clockchain.network/mcp \
--header "x-api-key: <YOUR_TOKEN>"
```
然后运行 `/mcp` （或客户端的等效命令），确认 `clockchain` （31种工具），并询问： *"使用clockchain获取当前共识时间。"* 自托管（本地stdio）、自带密钥和聊天连接器设置请参见 [`INSTALL.md`](INSTALL.md)。
## 请求代理连接 - 无需安装
没有机器需要设置？将任意具有MCP能力的代理（Claude Code、Cursor、Codex、Hermes、OpenClaw、Claude Desktop）交给以下提示 - 服务器已经托管，因此无需克隆或构建：
> 我想使用时钟链MCP服务器。它已经托管，所以 **不要** 克隆或构建任何仓库 - 只需通过HTTP连接到远程服务器。添加一个名为 `clockchain` 的MCP服务器，配置如下（替换我的令牌）：
> ```json
> { "mcpServers": { "clockchain": { "type": "http", "url": "https://mcp.clockchain.network/mcp", "headers": { "x-api-key": "<YOUR_TOKEN>" } } } }
> ```
> 然后列出您的MCP服务器以确认 `clockchain` 已连接，并调用其 `get_time` 工具以向我显示当前的时钟链共识时间。
向团队请求每个用户的令牌 - 时钟链密钥保留在服务器上。相同的托管端点 (`https://mcp.clockchain.network/mcp`) 可适用于任何MCP客户端。聊天连接器客户端（claude.ai聊天、Cowork）不同 - 请参见 [`INSTALL.md`](INSTALL.md)。
## 您获得的内容
**六个模块的31种工具：**
- **时间：** `get_time`, `get_timestamp`, `get_block`, `get_validation`.
- **日志（notarization）：** `log_action`, `get_log_entry`, `search_actions`, `verify_asset`.
- **调度器（智能合约）：** `get_contract_types`, `estimate_schedule`, `create_schedule`, `list_schedules`. 类型/估计/列表已上线；`create_schedule` 是预览版 - 它在后端签名消息规范上被阻止。调度 **非托管** ：调用者的EVM钱包签名，服务器从不伪造签名。
- **审计（衍生品 - 组合时间 + 日志 + 身份，无新原始数据）：** `generate_audit_trail`, `generate_compliance_report` （欧盟人工智能法案第12条 / 美国证券交易委员会第17a-4条 / ISO 27001预设），`build_evidence_package`, `verify_package`.
- **代理身份（验证，有效于T - 不是身份验证）：** `resolve_agent`, `attest_action`, `complete_attestation`, `verify_receipt`, `mint_identity`, `revoke_identity`, `delegate_authority`, `get_identity_history`, `verify_identity_at`, `verify_cross_party`. `attest_action` 使用 `wait=false` 提交而不阻塞；`complete_attestation` 是轮询已确认的收据直到区块落地。
- **承诺（TSA）：** `tsa_issue`, `tsa_checkpoint`, `tsa_attest`, `tsa_settle`, `tsa_status`. 锚定原语上的承诺生命周期 - 发布 → 检查点 → 证明（保留/破坏）→ 结算，以及状态。 `tsa_attest` 将链上锚定时间与截止日期协调到保留/ **破坏延迟** / **破坏** 判决；后果 **记录，但不强制执行** （MVP）。
**跨方验证已上线且无密钥：** `GET /searchAssetFromChain?blockHeight={h}` 使用 **无** API密钥读取不可变的链上区块。该区块 - 而不是可变的 `/ledger/{id}` 缓存 - 是权威记录；验证解决为链。
**软件包（此monorepo）：**
| 软件包 | 它是什么 |
|---|---|
| [`@clockchain/mcp-server`](packages/mcp-server) | MCP服务器 - `clockchain-mcp` (`dist/stdio.js`)，stdio + HTTP传输。 |
| [`@clockchain/core`](packages/core) | 共享客户端，类型，哈希/收据 + ERC-8004助手（仅限节点，无额外依赖）。 |
| [`@clockchain/web-demo`](packages/web-demo) | 浏览器聊天演示 - 一个LLM代理通过MCP驱动工具。 |
计划中的终端 `@clockchain/cli` - 请参见 [roadmap.md](./roadmap.md)。
## 状态
针对实时网关工作。MCP服务器 **已验证工作** - `initialize` + `tools/list` 返回31种工具，实时调用成功。验证表面（更新于2026-06-11）：
- **时间：** 从 **公共 `/getTime`** 读取共识时间（无密钥范围）。 `/api/time/*` 家族在日志范围密钥上401。
- **Notarization：** `/log`, `/ledger/{id}`, `/searchAsset`, `/getValidationBlock` 全部确认工作 - 日志，链上确认，检索，验证。
- **跨方验证：** **上线且无密钥** - `GET /searchAssetFromChain?blockHeight={h}` 使用 **无** API密钥读取不可变的链上区块，并且该区块是权威记录。
- **智能合约调度：** 合约类型，估计和列表 **上线** ； `create_schedule` 是预览版，在后端签名消息规范上被阻止。基于签名的和 **非托管** （调用者的EVM钱包签名）。
- **代理身份：** 验证（有效于T），不是身份验证。ERC-8004注册表已上线并解析；身份图写入（`mint`/`revoke`/`delegate`）解决了一个仍在预览中的目录。
- 设计用于 **法院级** 证据。单验证器测试网；严格的速率限制。
**完整的当前限制 + 路线图： [roadmap.md](./roadmap.md).**
## 托管，CI/CD和运维
托管在 **GCP Cloud Run** 上，网址为 `https://mcp.clockchain.network/mcp` （令牌保护 + 自带密钥），在 `main` 推送后自动部署在测试门后。
| 文件 | 它是什么 |
|---|---|
| [`CLOUD-RUN.md`](CLOUD-RUN.md) | 部署 + 运维手册：无密钥WIF CI/CD，Cloud Armor，监控，机密/令牌轮换，回滚。 **规范托管文档。** |
| [`cicd-plan.md`](cicd-plan.md) | CI/CD管道，不可协商的规则和前进计划。 |
| [`AGENTS.md`](AGENTS.md) | 贡献者/代理指南 - 在推送前运行测试，从不绕过部署门，每个工作树一个代理。 |
| [`auth-and-traffic-decision.md`](auth-and-traffic-decision.md) | 单ID前门，委托 vs 自带，Cowork vs Claude Code，通道/流量 + 成本模型。 |
| [`agentdash-mcp-integration-brief.md`](agentdash-mcp-integration-brief.md) | AgentDash团队的交接简报，以集成托管的MCP。 |
| [`eval/`](eval/) | 执行评分的评估框架 - Layer-A性能 + Layer-B代理任务套件（链上检查，无LLM裁判）。 |
| [`RETRO-2026-06-13.md`](RETRO-2026-06-13.md) | 06-11 → 06-13构建的回顾（Cloud Run，CI/CD，TSA，评估）。 |
`DELEGATED-ACCESS.md` 以下描述 **已弃用** 的Mac-mini路径 - 被 `CLOUD-RUN.md` 取代。
## 规格和规划文档
背景，设计决策和推出计划（此仓库最初是工作的规划表面，这些文档仍然存在）：
| 文件 | 它是什么 | 受众 |
|---|---|---|
| [`mcp-deployment-brief.md`](mcp-deployment-brief.md) | **从这里开始审批。** 一页简介：需求 + 部署依赖 + 网络暴露模型，带有利益相关者、网络团队和后端的签批块。 | 利益相关者 / 网络 / 后端 |
| [`DELEGATED-ACCESS.md`](DELEGATED-ACCESS.md) | 在没有API密钥或VPN的情况下为测试人员提供访问权限：Cloudflare Access位于网络演示 + MCP端点之前，带有令牌/速率/预算上限。 | 工程 / 运维 |
| [`implementation-plan.md`](implementation-plan.md) | 完整的技术规格和建设计划。真实来源。 | 工程 |
| [`implementation-plan-technical.html`](implementation-plan-technical.html) | 规格的幻灯片版本，带有设计细节。 | 工程审查 |
| [`implementation-plan.html`](implementation-plan.html) | 简短的高级概述幻灯片。 | 业务 / 利益相关者 |
| [`product-findings.md`](product-findings.md) | 来自实时网络 + 仪表板的实际发现。 | 产品 / 工程 |
| [`industry-landscape.md`](industry-landscape.md) | 关于领先的时间戳/出处平台的证据，以及Clockchain可以区分的领域。 | 产品 / 战略 |
| [`mcp-readiness.md`](mcp-readiness.md) | 每个工具的评估，哪些API准备好成为产品A和B的MCP工具，基于实时测试。 | 工程 / 产品 |
| [`journeys.md`](journeys.md) | 开发人员和代理的端到端旅程，标记当前API流程支持或破坏自主代理使用。 | 工程 / 产品 |
| [`product-a-identity-decision.md`](product-a-identity-decision.md) | 决策备忘录：专有DID vs ERC-8004 + SIWA用于代理身份。建议混合 - 采用标准，在时间/验证上区分。 | 产品 / 领导层 |
| [`deployment.md`](deployment.md) | 托管计划：本地stdio（开发人员），Mac mini测试主机（商业用户 + AgentDash）和AWS生产计划 + 信息检查清单。 | 工程 / 运维 |
| [`poc-build-plan.md`](poc-build-plan.md) | 目标 + 顺序计划，使MCP服务器在Mac mini上运行（及其与Clockchain的连接）。 | 工程 / 领导层 |
| [`roadmap.md`](roadmap.md) | 当前路线图，什么有效，什么有限制。 | 产品 / 工程 |
在浏览器中打开任意 `.html` 文件以演示（箭头键导航，`Esc` 进入幻灯片概览）。
