executor

演示动画

AI Agent 的集成层。通过一个统一的工具目录，实现所有 AI Agent 之间的工具共享。

快速入门

npm install -g executor
executor web

这将启动一个本地运行时环境，并在 http://127.0.0.1:4788 提供 Web UI。你可以从这里添加第一个数据源并开始使用工具。

作为 MCP 服务器使用

将任何支持 MCP 的 Agent（如 Cursor、Claude Code、OpenCode 等）指向 Executor，即可在它们之间共享你的工具目录、身份验证信息和策略。


executor mcp

适用于 Claude Code / Cursor 的 mcp.json 示例：

{
  "mcpServers": {
    "executor": {
      "command": "executor",
      "args": ["mcp"]
    }
  }
}

添加数据源

只要能用 JSON Schema 表示，它就可以成为一个集成。Executor 原生支持 OpenAPI、GraphQL、MCP 和 Google Discovery，但其插件系统对任何数据源类型开放。

通过 Web UI

打开 http://127.0.0.1:4788，进入 Add Source，粘贴 URL，Executor 将自动检测类型、索引工具并处理身份验证。

通过 CLI

executor call executor openapi addSource '{
  "spec": "https://petstore3.swagger.io/api/v3/openapi.json",
  "namespace": "petstore",
  "baseUrl": "https://petstore3.swagger.io/api/v3"
}'

当 OpenAPI 文档包含相对路径的 servers 条目（例如 "/api/v3"）时，请使用 baseUrl。

使用工具

Agent 通过类型安全的 TypeScript 运行时发现并调用工具：

// 按意图搜索
const matches = await tools.discover({ query: "github issues", limit: 5 });

// 检查 Schema
const detail = await tools.describe.tool({
  path: matches.bestPath,
  includeSchemas: true,
});

// 类型安全调用
const issues = await tools.github.issues.list({
  owner: "vercel",
  repo: "next.js",
});

通过 CLI 使用工具：

executor tools search "send email"
executor call --help
executor call github --help
executor call github issues --help
executor call cloudflare --help --match dns --limit 20
executor call github issues create '{"owner":"octocat","repo":"Hello-World","title":"Hi"}'
executor call gmail send '{"to":"alice@example.com","subject":"Hi"}'

executor call、executor resume 和 executor tools ... 命令会在必要时自动启动本地守护进程（daemon）。如果默认端口被占用，CLI 将自动选择一个可用的本地端口并进行跟踪。

如果执行过程因身份验证或审批而暂停，可以使用以下命令恢复：

executor resume --execution-id exec_123

CLI 参考

executor web                        # 启动运行时 + Web UI
executor daemon run                 # 在后台启动持久化本地守护进程
executor daemon status              # 查看守护进程状态
executor daemon stop                # 停止守护进程
executor daemon restart             # 重启守护进程
executor mcp                        # 启动 MCP 端点
executor call  '{"k":"v"}' # 通过路径片段调用工具
executor call  --help      # 浏览命名空间/资源/方法
executor call  --help --match "" --limit  # 缩小大型命名空间范围
executor resume --execution-id  # 恢复暂停的执行
executor tools search ""     # 按意图搜索工具
executor tools sources              # 列出已配置的数据源 + 工具计数
executor tools describe       # 显示工具的 TypeScript/JSON Schema

本地开发

bun install
bun dev

开发服务器将在 http://127.0.0.1:4788 启动。

社区

加入 Discord：https://discord.gg/eF29HBHwM6

了解更多

访问 executor.sh 了解详情。

致谢

感谢 Crystian 提供 npm 包名称 executor。

参考资料

作为编码过程的一部分，我让我的 Agent 访问其他代码库的参考资料，以便理解模式以及他人如何实现系统。

以下是一个非详尽的参考列表：

Better Auth - 存储适配器参考
Effect - 通用代码模式
OpenCode - 插件系统参考
OpenClaw - 插件系统参考
Emdash - 插件系统参考
Pi - 插件系统参考

同时也鼓励你将此代码库作为参考，以了解它是如何实现的。

RhysSullivan/executor