chron

AI 工具会显示您发送消息的时间。Chron 也会记录 AI 的响应时间，并为您使用的所有工具中的每一次交流保留一份永久的、可查询的记录。

适用于 Claude Desktop、Claude Code、Cursor、Windsurf 以及任何兼容 MCP 的 AI 工具。

为什么需要它

AI 工具默认不提供审计追踪。您无法回答以下问题：

• AI 说了什么，具体是什么时候说的？

• AI 响应花了多长时间？

• 产生此输出的完整对话是什么？

• 上周我向 Claude 询问了关于这个代码库的什么内容？

Chron 解决了这些问题。每一次交流都会连同精确的本地日期时间（包括时区偏移）记录到您拥有的 SQLite 文件中。没有云端，没有供应商锁定，数据不会离开您的机器。

安装

添加到您的 AI 工具的 MCP 配置中：

{
  "mcpServers": {
    "chron": {
      "command": "npx",
      "args": ["-y", "chron-mcp"]
    }
  }
}

首次运行会自动创建 ~/.chron/chron.db。无需数据库设置，无需环境变量，无需迁移。

记录内容

每一次交流都会记录精确的本地时间戳 —— 收到用户消息的时间，以及发送助手响应的时间：

[user: 2026-05-08 14:32:11 +02:00 | assistant: 2026-05-08 14:32:43 +02:00]

The main risks of deploying this contract are...

用户时间戳和助手时间戳之间的间隔即为实际生成时间。两者都存储在您的本地 SQLite 数据库中，并带有完整的时区偏移。

各工具配置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "chron": {
      "command": "npx",
      "args": ["-y", "chron-mcp"]
    }
  }
}

Claude Code

claude mcp add chron npx -y chron-mcp

然后将技能钩子添加到 ~/.claude/settings.json：

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cat ~/.chron/chron.skill.md"
          }
        ]
      }
    ]
  }
}

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "chron": {
      "command": "npx",
      "args": ["-y", "chron-mcp"]
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "chron": {
      "command": "npx",
      "args": ["-y", "chron-mcp"]
    }
  }
}

配套技能文件

Chron 附带 skills/chron.skill.md —— 这是一个纯文本指令文件，告诉 AI 如何自动使用 MCP 工具。将其加载到您的 AI 工具中一次即可。之后，AI 将：

1. 在每次对话开始时创建或恢复一个命名会话

2. 在开始响应之前记录您的消息（捕获真实的用户时间戳）

3. 在撰写完成后记录其响应（捕获真实的助手时间戳）

4. 在每次响应顶部显示 [user: YYYY-MM-DD HH:MM:SS ±HH:MM | assistant: YYYY-MM-DD HH:MM:SS ±HH:MM]

5. 检索之前的会话历史记录，确保对话间的上下文永不丢失

MCP 工具

配置

HTTP+SSE 模式（团队/自托管）

对于团队或远程使用，请将 Chron 作为 HTTP 服务器运行：

CHRON_TRANSPORT=http CHRON_API_KEY=your-key PORT=3001 npx chron-mcp

将您的 MCP 配置指向该 URL：

{
  "mcpServers": {
    "chron": {
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer your-key"
      }
    }
  }
}

您的数据

您的审计日志位于 ~/.chron/chron.db —— 这是您机器上的单个 SQLite 文件。使用任何 SQLite 工具直接查询它：

sqlite3 ~/.chron/chron.db \
  "SELECT s.title, m.role, m.content, m.created_at
   FROM messages m JOIN sessions s ON s.id = m.session_id
   ORDER BY m.created_at"

没有云端，没有遥测，数据不会离开您的机器。使用 CHRON_DB_PATH 更改位置。

许可

版权所有 (c) 2026 Nivaya。保留所有权利。

源代码仅为透明起见公开。未经明确书面许可，禁止克隆、分叉、修改和重新分发。完整条款请参阅 LICENSE。