Runhooks

Name: Runhooks
Author: runhooks

本地服务

runhooks.app云与基础设施01 周前更新

代码仓库访问官网

关于 Runhooks

Runhooks 是供 AI Agent 使用的本地 MCP 服务，可通过 Runhooks API 安排和管理一次性或周期性 HTTP 任务。其工具还涵盖执行历史、重放、用量和失败提醒。

主要功能

01创建 cron 或间隔任务
02列出和管理定时任务
03暂停和恢复任务
04查看并重放执行记录
05管理失败提醒

适用场景

01安排周期性 HTTP 请求
02设置一次性 HTTP 任务
03重放过往任务执行
04接收任务失败提醒

MCP 相关

服务在本地运行，通过 HTTPS 将 MCP 客户端连接到 Runhooks REST API。它提供创建和管理任务、执行记录、用量、账户及提醒的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "runhooks-runhooks": {
      "command": "npx",
      "args": [
        "-y",
        "@runhooks/mcp"
      ],
      "env": {
        "RUNHOOKS_API_KEY": "<RUNHOOKS_API_KEY>",
        "RUNHOOKS_API_URL": "<RUNHOOKS_API_URL>"
      }
    }
  }
}

启动命令npx -y @runhooks/mcp

需要配置的环境变量

RUNHOOKS_API_KEY密钥Runhooks API key (rh_live_...). Required for all tools except provision_account; get one instantly with the provision_account tool, the dashboard, or the CLI.

RUNHOOKS_API_URLAPI origin override. Defaults to https://api.runhooks.app.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@runhooks/mcp0.1.10stdio

工具

收录的工具列表 · 更新于 6 天前

参数	类型	必填	说明
name	string	否	账户的可选显示名称

详细介绍

@runhooks/mcp

Runhooks 的模型上下文协议（MCP）服务，适用于 Runhooks——可靠的 HTTP 调度基础设施。它让 AI Agent（Claude Desktop、Cursor 和任何 MCP 客户端）可以直接安排和管理定期及一次性 HTTP 任务。

该服务在你的机器上本地运行：MCP 客户端通过 npx 启动它，然后它通过 HTTPS 与 Runhooks REST API 通信。没有托管服务，只有这个软件包。

安装

将其添加到 MCP 客户端配置中。以 Claude Desktop（claude_desktop_config.json）为例：

{
  "mcpServers": {
    "runhooks": {
      "command": "npx",
      "args": ["-y", "@runhooks/mcp"],
      "env": { "RUNHOOKS_API_KEY": "rh_live_..." }
    }
  }
}

还没有 API 密钥？请省略 env，并让 Agent 运行一次 provision_account 工具——它会立即创建账户（无需电子邮箱），返回一个 rh_live_... 密钥，并将其保存到本地的 ~/.runhooks/mcp.json。之后会自动重复使用该密钥，因此其他所有工具都能立即使用，无需重启或再次创建账户。（在不同机器间使用时，设置 RUNHOOKS_API_KEY 仍是最通用的选项，而且它始终优先于已保存的密钥。）

验证

检查服务是否启动并公布其工具（替换密钥，或省略 env，然后在客户端内使用 provision_account）：

RUNHOOKS_API_KEY=rh_live_... npx -y @runhooks/mcp

环境变量

变量	描述	默认值
`RUNHOOKS_API_KEY`	你的 API 密钥（`rh_live_...`）。可选——如果未设置，`provision_account` 会在本地保存密钥。优先于已保存的密钥。	—
`RUNHOOKS_API_URL`	API 源地址。	`https://api.runhooks.app`

工具

工具	描述
`provision_account`	创建匿名账户并获取 API 密钥（无需电子邮箱）。
`whoami`	显示当前账户。
`rotate_key`	轮换 API 密钥。
`create_job`	创建计划任务（cron 或间隔）。
`list_jobs`	根据筛选条件和分页列出任务。
`get_job`	根据 ID 获取单个任务。
`update_job`	更新任务。
`delete_job`	删除任务。
`pause_job` / `resume_job`	暂停或恢复任务。
`list_executions`	列出任务的运行历史。
`replay_execution`	重新运行过去的执行。
`get_usage`	显示套餐用量和限制。
`list_alerts` / `create_alert` / `get_alert` / `update_alert` / `delete_alert`	管理失败提醒（电子邮件、webhook、Slack）。