cueapi-mcp

CueAPI 的官方 Model Context Protocol 服务器，CueAPI 是 AI 代理系统的开源协调层。

让您支持 MCP 的助手（Claude Desktop、Cursor、Zed 或任何其他 MCP 主机）能够在对话中调度代理工作、获取执行历史记录，并使用基于证据的结果报告来闭环。

为什么

代理无法通过一次调用完成任务。它们需要在时间、工具、环境、代理和人类之间进行协调。每一次交接都是隐藏静默失败的地方。CueAPI 通过结构化证据（外部 ID、结果 URL 或工件）来结束每一次交接。此 MCP 服务器为代理提供了对该表面的直接访问，因此代理既可以调度自己的后续工作，也可以提供带有证明的结果报告。

Related MCP server: moo-tasks

安装

npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp

配置 (Claude Desktop)

将其添加到您的 Claude Desktop 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "cueapi": {
      "command": "npx",
      "args": ["-y", "@cueapi/mcp"],
      "env": {
        "CUEAPI_API_KEY": "cue_sk_..."
      }
    }
  }
}

在 cueapi.ai 生成您的 API 密钥。自托管？请设置 CUEAPI_BASE_URL 以及 CUEAPI_API_KEY。

配置 (Cursor / Zed / 其他主机)

任何支持 stdio 服务器的 MCP 主机都可以运行此程序。将主机指向 cueapi-mcp 二进制文件，并在环境中传递 CUEAPI_API_KEY。

公开的工具

对话示例

您： 安排一个每天上午 9 点的工作，将摘要发布到我的 webhook。

助手（使用 cueapi_create_cue）： 已创建提示 cue_abc123，首次触发时间为明天 UTC 时间 9:00。

您： 向我展示它最后五次的运行记录。

助手（使用 cueapi_list_executions）： ...

开发

npm install
npm test        # vitest smoke tests for the tool surface
npm run build   # compile TypeScript to dist/
npm run dev     # run the server locally with tsx

链接

• CueAPI 主页： https://cueapi.ai

• 文档： https://docs.cueapi.ai

• 核心（开源）： https://github.com/cueapi/cueapi-core

• Model Context Protocol： https://modelcontextprotocol.io

更新日志

• 0.4.1. 添加 cueapi_update_cue 工具：更新提示的可变字段（名称、调度、回调 URL、时区、负载、描述）。封装 PATCH /v1/cues/{id}。稀疏更新 — 仅发送提供的字段。弥补了跨包装器的对等差距（其他所有客户端包装器都公开了更新；MCP 之前没有）。

• 0.4.0. 添加五个执行生命周期工具 — cueapi_get_execution、cueapi_list_claimable_executions、cueapi_claim_execution、cueapi_claim_next_execution、cueapi_execution_heartbeat。为希望在会话内（例如 Claude Desktop、Cursor、Zed）使用工作者传输执行记录的 MCP 主机代理关闭了接收-领取-处理-完成循环。亮点：list_claimable_executions 通过 task / agent 查询参数在服务器端进行过滤（客户端过滤会遇到已知的 LIMIT-50 饥饿错误）；claim_next_execution 接受可选的 task_name 并在内部进行扇出（过滤列表 → 选择最旧的 → 按 ID 领取），因为服务器尚不支持在原始领取端点上进行任务过滤；execution_heartbeat 通过 X-Worker-Id 请求头发送 worker_id（服务器用于该字段的传输），并要求在模式中包含它，以便配置错误的调用者在包装器处失败，而不是静默绕过竞争保护。内部：CueAPIClient.request() 获得了一个可选的 extraHeaders 参数，以支持每次调用的自定义标头。

• 0.3.0. 添加 cueapi_fire_cue 工具：使用可选的 payload_override（以及 merge_strategy: 'merge' | 'replace'，默认为 'merge'）立即触发现有提示。封装 POST /v1/cues/{id}/fire。让代理无需创建一次性提示即可触发临时执行，并让每次触发的动态数据流向 webhook 分发 + 工作者领取响应，而无需更改存储的提示。

• 0.1.4. 修复 cueapi_pause_cue / cueapi_resume_cue 以使用 PATCH /v1/cues/{id} 和 {"status": "paused" | "active"}（之前调用了不存在的 /pause 和 /resume 端点，返回运行时 404）。PR #1。这是实际包含修复的版本；0.1.3 在发布时带有此说明，但未合并代码。

• 0.1.3. 过早发布，被 0.1.4 取代。与 0.1.2 相比没有功能变化。

• 0.1.2. 在官方 MCP 注册表中注册。

• 0.1.0. 初始版本：8 个用于创建/列出/获取/暂停/恢复/删除提示、列出执行记录、报告结果的工具。

许可证

MIT © Vector Apps Inc.