Tickstem

tickstem/mcp

Tickstem 用の MCP サーバーです。cron ジョブのスケジュール設定、稼働状況の監視、ハートビート監視、メールアドレスの検証機能を、AI コーディングアシスタント（Claude、Cursor、Copilot、および MCP 互換のあらゆるエージェント）向けのネイティブツールとして提供します。

アプリのコードを書きながら、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