Tickstem

tickstem/mcp

Tickstem 的 MCP 服务（Tickstem），将 cron 作业调度、运行时间监控、心跳监控和电子邮件验证作为原生工具提供给 AI 编码助手（Claude、Cursor、Copilot 以及任何兼容 MCP 的 Agent）。

编写应用代码时，让 AI 助手注册 cron 作业、创建带有响应断言的运行时间监控、管理心跳监控、验证电子邮件地址并查询结果。

安装

下载预构建二进制文件（无需 Go）：

平台	二进制文件
macOS（Apple Silicon）	tsk-mcp-darwin-arm64
macOS（Intel）	tsk-mcp-darwin-amd64
Linux（x86-64）	tsk-mcp-linux-amd64
Linux（ARM64）	tsk-mcp-linux-arm64
Windows（x86-64）	tsk-mcp-windows-amd64.exe

从 Releases 下载，设置为可执行文件，并放到你的 PATH 中：

# macOS / Linux example
chmod +x tsk-mcp-darwin-arm64
mv tsk-mcp-darwin-arm64 /usr/local/bin/tsk-mcp

或使用 Go 安装：

go install github.com/tickstem/mcp/cmd/tsk-mcp@latest

快速开始

export TICKSTEM_API_KEY=tsk_your_key_here
tsk-mcp

该服务通过 stdio 使用 Model Context Protocol 通信，可将其连接到任何兼容 MCP 的客户端。

Claude Code

添加到你的 ~/.claude/claude_desktop_config.json（或同类配置文件）中：

{
  "mcpServers": {
    "tickstem": {
      "command": "tsk-mcp",
      "env": {
        "TICKSTEM_API_KEY": "tsk_your_key_here"
      }
    }
  }
}

可用工具

Cron 作业

工具	描述
list_jobs	列出账户中的所有 cron 作业
get_job	按 ID 获取 cron 作业
register_job	注册新的 cron 作业（名称、计划、端点）
update_job	更新现有作业——仅修改提供的字段
pause_job	暂停作业，使其不再触发
resume_job	恢复已暂停或失败的作业
delete_job	永久删除作业及其执行历史记录
list_executions	列出作业的执行历史记录，按时间从近到远排序

运行时间监控

工具	描述
list_monitors	列出所有监控项——状态、URL、间隔、SSL 到期时间、断言
create_monitor	创建监控项，可选响应断言（状态码、响应时间、正文）
get_monitor	按 ID 获取监控项
pause_monitor	暂停监控项，使其停止轮询
resume_monitor	恢复已暂停的监控项
delete_monitor	永久删除监控项及其检查历史记录
list_monitor_checks	列出最近的检查记录——状态、HTTP 代码、耗时、错误、SSL 到期时间

响应断言

create_monitor 接受 assertions 参数，这是一个 JSON 条件数组，所有条件都必须通过，检查结果才会被视为正常。设置断言后，它们将取代默认的 2xx/3xx 判断逻辑。

[
  { "source": "status_code",   "comparison": "eq",       "target": "200"              },
  { "source": "response_time", "comparison": "lt",       "target": "2000"             },
  { "source": "body",          "comparison": "contains", "target": "\"status\":\"ok\"" }
]

来源	有效比较方式	目标值
status_code	eq ne lt lte gt gte	整数字符串
response_time	eq ne lt lte gt gte	整数字符串（ms）
body	eq ne contains not_contains	纯文本字符串

心跳监控

工具	描述
list_heartbeats	列出所有心跳监控——状态、令牌、间隔、宽限窗口、上次 ping 时间
create_heartbeat	创建心跳监控（死亡开关）
get_heartbeat	按 ID 获取心跳监控
update_heartbeat	更新名称、间隔或宽限窗口
pause_heartbeat	在计划停机期间抑制告警
resume_heartbeat	暂停后恢复告警
delete_heartbeat	永久删除心跳监控及其 ping 历史记录
ping_heartbeat	记录一次成功的作业运行——无需 API 密钥，令牌即为凭证
list_heartbeat_pings	列出心跳监控最近的 ping，按时间从近到远排序

邮箱验证

工具	描述
verify_email	检查语法、MX 记录、一次性邮箱域名和基于角色的前缀
list_verify_history	列出该账户过去的验证结果

环境变量

变量	必填	描述
TICKSTEM_API_KEY	是	来自 app.tickstem.dev 的 API 密钥
TICKSTEM_BASE_URL	否	覆盖 API 基础 URL（例如，用于本地开发的 http://localhost:8080/v1）

本地开发

export TICKSTEM_API_KEY=tsk_your_key_here
export TICKSTEM_BASE_URL=http://localhost:8080/v1
go run ./cmd/tsk-mcp

SDK

MCP 服务负责通过 AI 助手管理基础设施。对于应用程序代码，请使用与编程语言相匹配的 SDK：

语言	安装	文档
Python	pip install tickstem	github.com/tickstem/python
Go（cron）	go get github.com/tickstem/cron	pkg.go.dev
Go（uptime）	go get github.com/tickstem/uptime	pkg.go.dev
Go（heartbeat）	go get github.com/tickstem/heartbeat	pkg.go.dev
Go（verify）	go get github.com/tickstem/verify	pkg.go.dev
Node.js	npm install @tickstem/cron	github.com/tickstem/node

所有 SDK 都使用相同的 API 密钥。

获取 API 密钥

app.tickstem.dev — 免费套餐每月包含 1,000 次 cron 执行、5 个运行状况监控器、5 个心跳监控器和 500 次邮箱验证。

许可证

MIT