SuperAPI AI 工具集

inngest-cli

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:Inngest CLI 提供 Dev Server,即开源本地版 Inngest 平台,用于本地开发、测试、serve 端点调试、Docker 部署、MCP 接入与自托管生产运行。技能内容以 TypeScript 为主,Python 与 Go 需参考官方文档。

安装与启动:推荐 npx inngest-cli@latest dev,也可用 yarn dlx、pnpm dlx;全局安装 npm install -g inngest-cli;Docker 镜像 docker pull inngest/inngest。若 npm 禁用生命周期脚本导致二进制缺失,可用 npx --ignore-scripts=false inngest-cli@latest dev。

主要能力:inngest dev 启动内存版本地服务,UI 位于 http://localhost:8288,支持 -u 指定 serve 端点、-p 指定端口、多应用、--no-discovery 关闭自动发现、--persist 持久化等。自动发现会扫描常见端口及 /api/inngest、/x/inngest 等端点。可用 inngest.json/yaml/toml 配置。

测试与调试:可用 curl 检查 serve 端点,返回 functionsFound 数量;通过 SDK 或 curl 向 http://localhost:8288/e/test 发送事件;使用 @inngest/test(需 inngest>=4.0.0)做单元测试,支持执行整个函数、单步、断言状态、模拟事件与步骤。

Docker 与 MCP:Docker 运行需映射 8288 与 8289,Linux 需处理 host.docker.internal;Compose 中应用须设 INNGEST_DEV=1。Dev Server 在 http://127.0.0.1:8288/mcp 暴露 MCP,可接入 Claude Code 或 Cursor,提供 send_event、list_functions、invoke_function 等工具。

自托管生产:inngest start 用于生产,需 --event-key 与 --signing-key,可配置 Redis、PostgreSQL、SQLite 等;默认内存 Redis 与 ./.inngest/main.db。部署后可用 curl -X PUT 同步,生产需设置 INNGEST_EVENT_KEY 与 INNGEST_SIGNING_KEY。

限制:部分平台需显式设置 INNGEST_SERVE_ORIGIN、INNGEST_SERVE_PATH;Cloud Run 1st gen 不受官方支持;外部 webhook 本地测试需隧道。具体环境变量与部署细节以当前 CLI 与部署文档为准。