自架服務
UsefulSoftwareCo/executor avatar
UsefulSoftwareCo/executor

Executor:針對 MCP 相容代理的統一整合目錄

人工智慧代理缺失的整合層。讓他們在安全環境中呼叫任何 OpenAPI / MCP / GraphQL / 自訂 js 函數。

3,768 個 Star305 個 ForkTypeScriptMIT

秒懂

它是什麼?
一個開放原始碼層,讓代理透過 MCP 共享 API、驗證與個別工具政策。
適合誰用?
Executor 集中管理整合、憑證與政策,讓任何 MCP 相容代理都能使用同一目錄。專案採用 MIT 授權,README 記載了雲端、本機與自架部署方式。
可以商用嗎?
可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫最近一次提交在 1 天前。
用什麼語言寫的?
主要是 TypeScript(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月14日)與我們的分析,不構成法律意見。

開源專案深度解析

每種整合只設定一次,所有代共用

Executor 是一個針對 AI 代理的開放原始碼整合層。其出發點是:目前每個代理都需要各自設定每一套整合,相同的 API 金鑰要貼到多個用戶端,相同的 MCP 伺服器要重複設定,而且對於每個工具允許做什麼,沒有統一的理解。Executor 位於中間層。您只需新增一次工具、設定一次憑據、設定一次政策,任何 MCP 相容代理都能使用同一目錄。README 列出對 MCP 伺服器、OpenAPI、GraphQL 和 Google Discovery 的一流支援,並說明任何能用 JSON schema 描述的內容都可以成為整合。

針對「每種整合只設定一次,所有代理共用」的第 1 個核對面向,Executor 把整合、連線和工具政策拆成不同層次,這讓同一個 API 可以被多個 MCP agent 使用,也讓核准與封鎖規則有集中位置。驗證時可用 `executor tools search` 找工具,以 `executor call` 觀察 schema、驗證暫停與 `executor resume --execution-id` 的恢復流程。

在「每種整合只設定一次,所有代理共用」這個範圍內,executor 的核對點是第 1 節所列的輸入與輸出。README 沒有說明更細的相容性或效能保證,因此本文只把已記錄的命令、檔案與設定鍵當作可核對的範圍。

整合、連線與個別具政策

README 明確描述了工作流程。首先新增一個整合:可以是 MCP 伺服器、OpenAPI 規範或 GraphQL API。然後建立連線,連線是該整合的一個已設定且可選擇驗證的實例;一個整合可以有多個連線。接著設定政策,決定每個工具是永遠允許、需要核准還是被封鎖。最後,讓代理透過 MCP 指向 Executor,這樣它們就共享同一個目錄。README 也提到,政策的合理預設值來自規範,並提供指向 Concepts 文件的連結。

針對「整合、連線與個別工具政策」的第 2 個核對面向,Node.js 20 以上是 README 記載的本機前提;雲端、CLI、桌面與自架形式的效能差異則沒有量化說明。把 OpenAPI 或 MCP 接入前,應先檢查憑證如何儲存、工具預設政策如何落地,以及 `examples/` 的流程能否對應自己的權限模型。

在「整合、連線與個別工具政策」這個範圍內,executor 的核對點是第 2 節所列的輸入與輸出。README 沒有說明更細的相容性或效能保證,因此本文只把已記錄的命令、檔案與設定鍵當作可核對的範圍。

部署方式:雲端、CLI、桌面與自架

Executor 提供多種形式,README 稱它們暴露相同的功能,只是打包方式不同。Executor Cloud 是最快的啟動方式,本機無需安裝。CLI 在無頭或伺服器環境中執行本機背景服務。桌面應用支援 Mac、Windows 與 Linux。如果您希望使用自己的基礎設施,還有 Docker 與 Cloudflare Worker 的自架選項。本機使用時,快速開始要求 Node.js 20 或更高版本,並可透過 npm、pnpm、bun 或 yarn 全域安裝 executor 套件,然後執行 `executor install` 與 `executor web`。README 沒有說明這些形式之間在效能或功能上的差異。

針對「部署方式:雲端、CLI、桌面與自架」的第 3 個核對面向,Executor 把整合、連線和工具政策拆成不同層次,這讓同一個 API 可以被多個 MCP agent 使用,也讓核准與封鎖規則有集中位置。驗證時可用 `executor tools search` 找工具,以 `executor call` 觀察 schema、驗證暫停與 `executor resume --execution-id` 的恢復流程。

在「部署方式:雲端、CLI、桌面與自架」這個範圍內,executor 的核對點是第 3 節所列的輸入與輸出。README 沒有說明更細的相容性或效能保證,因此本文只把已記錄的命令、檔案與設定鍵當作可核對的範圍。

連線 MCP 用戶端並新增整合

要連線代理,README 展示了使用 add-mcp 套件,它會偵測用戶端並寫入設定。透過 HTTP 連線的指令是 `npx add-mcp http://127.0.0.1:4788/mcp --transport http --name executor`;透過 stdio 則是 `npx add-mcp "executor mcp" --name executor`。Web UI 的 Connect 卡片會顯示已填好的確切指令與連接埠。對於整合,Web UI 接受 OpenAPI、GraphQL 或 MCP 的 URL,並處理類型偵測、工具索引與驗證。CLI 範例新增 Petstore OpenAPI 規範,包含命名空間與選用的 baseUrl 以處理相對伺服器位址。README 也指出,大多數 MCP 用戶端在啟動時載入伺服器,因此可能需要重新啟動用戶端。

針對「連線 MCP 用戶端並新增整合」的第 4 個核對面向,Node.js 20 以上是 README 記載的本機前提;雲端、CLI、桌面與自架形式的效能差異則沒有量化說明。把 OpenAPI 或 MCP 接入前,應先檢查憑證如何儲存、工具預設政策如何落地,以及 `examples/` 的流程能否對應自己的權限模型。

在「連線 MCP 用戶端並新增整合」這個範圍內,executor 的核對點是第 4 節所列的輸入與輸出。README 沒有說明更細的相容性或效能保證,因此本文只把已記錄的命令、檔案與設定鍵當作可核對的範圍。

從 CLI 與 TypeScript 呼叫具

CLI 提供基於意圖的搜尋(`executor tools search "send email"`)、命名空間瀏覽(`executor call github issues --help`)以及帶 JSON 參數的直接呼叫。`executor call`、`executor resume` 與 `executor tools` 等指令會自動啟動本機守護程式,如果預設連接埠被佔用,會選擇空閒連接埠。如果執行因驗證或核准而暫停,可使用 `executor resume --execution-id` 恢復。對於嵌入使用,TypeScript SDK 提供 Promise API 與 Effect 原生 API。README 中有一個簡短範例,建立帶有 OpenAPI 外掛的 executor,列出工具並取得 schema。可執行的範例位於 examples 目錄。

針對「從 CLI 與 TypeScript 呼叫工具」的第 5 個核對面向,Executor 把整合、連線和工具政策拆成不同層次,這讓同一個 API 可以被多個 MCP agent 使用,也讓核准與封鎖規則有集中位置。驗證時可用 `executor tools search` 找工具,以 `executor call` 觀察 schema、驗證暫停與 `executor resume --execution-id` 的恢復流程。

在「從 CLI 與 TypeScript 呼叫工具」這個範圍內,executor 的核對點是第 5 節所列的輸入與輸出。README 沒有說明更細的相容性或效能保證,因此本文只把已記錄的命令、檔案與設定鍵當作可核對的範圍。

Monorepo 構、開發與授權

該倉庫是 Bun 與 Turborepo monorepo。README 列出 CLI、桌面、本機執行環境、雲端、自架伺服器、Cloudflare Worker、行銷網站與文件等應用,以及 core、kernel、plugins、hosts、react 與 app 等套件。開發從 `bun install`、`bun run bootstrap`(新檢出必須執行)與 `bun run dev` 開始。測試分為單元與整合測試(`bun run test`)以及全端端到端測試(`bun run test:e2e`),後者會啟動雲端與自架應用。專案採用 MIT 授權,版權歸 Rhys Sullivan 所有;授權授予使用、複製、修改、合併、發布、分發、再授權與銷售副本的權利,並聲明不提供任何擔保。README 沒有描述安全保證或生產結果。

針對「Monorepo 結構、開發與授權」的第 6 個核對面向,Node.js 20 以上是 README 記載的本機前提;雲端、CLI、桌面與自架形式的效能差異則沒有量化說明。把 OpenAPI 或 MCP 接入前,應先檢查憑證如何儲存、工具預設政策如何落地,以及 `examples/` 的流程能否對應自己的權限模型。

在「Monorepo 結構、開發與授權」這個範圍內,executor 的核對點是第 6 節所列的輸入與輸出。README 沒有說明更細的相容性或效能保證,因此本文只把已記錄的命令、檔案與設定鍵當作可核對的範圍。

編輯結論

Executor 集中管理整合、憑證與政策,讓任何 MCP 相容代理都能使用同一目錄。專案採用 MIT 授權,README 記載了雲端、本機與自架部署方式。 對 executor 而言,先按 README 的專屬命令與檔案完成最小流程,再核對輸出、權限與失敗行為;不適合把未記載的平台支援或效能承諾當成既定事實。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記