内容
# cron-mcp
一个 [Claude 代码频道](https://code.claude.com/docs/en/channels-reference) ,允许 Claude 安排提醒和重复任务。当作业触发时,它会作为频道事件返回到同一会话中 — Claude 会自然地处理它,就像它简单地记得跟进一样。
## 要求
- [Bun](https://bun.sh/) (或带有 tsx/ts-node 的 Node.js)
- Claude Code v2.1.80 或更高版本,带有 claude.ai 登录
## 安装
```sh
git clone https://github.com/youruser/cron-mcp
cd cron-mcp
bun install
```
## 添加到 Claude Code
**项目级** — 添加到存储库根目录中的 `.mcp.json`:
```json
{
"mcpServers": {
"cron-mcp": {
"command": "bun",
"args": ["/绝对路径/to/cron-mcp/index.ts"]
}
}
}
```
**用户级** — 在每个项目中可用,添加 `~/.claude.json`:
```json
{
"mcpServers": {
"cron-mcp": {
"command": "bun",
"args": ["/绝对路径/to/cron-mcp/index.ts"]
}
}
}
```
## 启动 Claude Code
在研究预览期间,频道需要一个开发标志:
```sh
claude --dangerously-load-development-channels server:cron-mcp
```
## 用法
只需自然地与 Claude 交谈。它将安排作业而不向您显示任何实现细节。
> "提醒我在 30 分钟后检查部署。"
> "每 4 小时与我联系,直到一天结束。"
> "提醒我在明天 9 点查看 PR 。"
Claude 在内部使用 `cron` 工具。您无需直接与其交互。
## 工作原理
- 作业存储在工作目录中的 `.cron-mcp/jobs.json` 中,如果目录不可写,则存储在 `~/.config/cron-mcp/jobs.json` 中。设置 `$CRON_MCP_STORE` 以覆盖。
- 作业在进程重启后仍然存在 — 任何逾期的作业在服务器启动时立即触发。
- 一次性作业在触发后删除。重复作业会自行重新安排。
## 时长格式
当 Claude 在内部安排作业时,时长被写为一个或多个空格分隔的部分:
| 示例 | 含义 |
|---------|---------|
| `30m` | 30 分钟 |
| `1h 30m` | 1.5 小时 |
| `2d 4h` | 2 天和 4 小时 |
| `90s` | 90 秒 |
支持的后缀:`s`(秒),`m`(分钟),`h`(小时),`d`(天)。