cueport
cueport允许MCP主机或终端访问CueAPI 代理工作的协调层：调度提示(循环的cron或 一次性)，按要求解雇他们，看着他们被处决，索赔工人 执行死刑，用心跳来维持索赔，结束循环 通过报告有证据支持的结果。一个二进制服务于 命令行接口和stdio MCP服务器。
需要API密钥。集 CUEAPI_API_KEY 从你的
CueAPI账户;每个呼叫都发送它为 Authorization: Bearer <key>，并且在尝试任何请求之前丢失密钥失败。
自托管还是针对另一个主机进行测试？集 CUEAPI_BASE_URL
旁边的钥匙；未设置时，呼叫转到
https://api.cueapi.ai.
安装
npx @reneturcios/cueport list-cues
或者运行容器镜像：
docker run -i ghcr.io/cloudcorprecords/cueport
容器默认为MCP服务器（见下文）。通过CLI 参数将其用作CLI。
命令行界面
cueport create-cue --name digest --schedule "0 9 * * *" --callback-url https://example.test/hook
cueport list-cues --status active --limit 5
cueport get-cue cue_abc123
cueport fire-cue cue_abc123 --payload-override '{"topic":"release notes"}'
cueport update-cue cue_abc123 --name "morning digest"
cueport pause-cue cue_abc123
cueport resume-cue cue_abc123
cueport delete-cue cue_abc123
cueport list-executions --cue-id cue_abc123 --status failed
cueport get-execution exec_123
cueport list-claimable --task digest --agent worker-a
cueport claim-execution exec_123 --worker-id worker-7
cueport claim-next --task-name digest --worker-id worker-7
cueport heartbeat exec_123 --worker-id worker-7
cueport report-outcome exec_123 --outcome succeeded --external-id ext_42 --result-url https://example.test/result
cueport --version
命令打印上游JSON负载。退出代码: 0 在
成功, 1 当调用失败时（包括丢失API密钥或错误）
上游API错误)， 2 使用错误。
有两种行为值得了解。暂停和恢复则不是
单独的端点：都是a PATCH /v1/cues/{id} 只带了一个
状态字段(paused 或者 active）. 和 claim-next 是扇形的，
没有单个调用：索赔端点没有任务筛选器，因此
工具首先获取服务器端过滤的可声明列表，然后选择
最老的条目，然后通过id声明执行。
MCP服务器
一个箱子能同时满足两个人的需要。这个 mcp subcommand启动stdio MCP
服务器:
npx -y @reneturcios/cueport mcp
MCP客户端配置：
{
"mcpServers": {
"cueport": {
"command": "npx",
"args": ["-y", "@reneturcios/cueport", "mcp"],
"env": {
"CUEAPI_API_KEY": "cue_sk_..."
}
}
}
}
添加 CUEAPI_BASE_URL 到 env 块将服务器指向
不同的cueapi兼容主机。
工具
| 工具 | 输入 | 它是做什么的 |
|---|---|---|
cueapi_create_cue | name， schedule (需要);可选的描述、回调、方法、时区、有效负载、任务和平台字段 | 创建一个循环的或一次性的提示。 |
cueapi_list_cues | status， limit (可选) | 列出线索，按状态过滤。 |
cueapi_get_cue | cue_id | 拿一根球杆。 |
cueapi_fire_cue | cue_id;可选 payload_override， merge_strategy （merge 默认情况下,或 replace） | 立即发出信号。 |
cueapi_update_cue | cue_id 加上任何可变提示字段 | 稀疏的更新;只发送提供的字段。 |
cueapi_pause_cue | cue_id | 暂停一个提示（PATCH with status） paused）。 |
cueapi_resume_cue | cue_id | 恢复一个带有状态的提示（PATCH） active）。 |
cueapi_delete_cue | cue_id | 永久删除提示。 |
cueapi_list_executions | cue_id， status， limit (可选) | 按提示和状态筛选列出执行情况。 |
cueapi_get_execution | execution_id | 获取一个带有状态和结果的执行。 |
cueapi_list_claimable_executions | task， agent， limit (可选) | 列出未认领的工作线程执行，过滤服务器端。 |
cueapi_claim_execution | execution_id;可选 worker_id | 自动声明一次执行。 |
cueapi_claim_next_execution | task_name， worker_id (可选) | 申请最古老的可申请死刑。 |
cueapi_execution_heartbeat | execution_id， worker_id (需要) | 延长债权租赁； worker_id 在旅行中 X-Worker-Id 头。 |
cueapi_report_outcome | execution_id， outcome (需要);可选证据字段 | 报告一次写的结果和证据。 |
开发
npm install
npm run build # tsc -> dist/
npm test # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev # run the CLI from source via tsx
许可证
MIT -见 LICENSE.