oomol-lab/open-connector

Open-source auth gateway connecting 1500+ SaaS providers to AI agents through SDK, CLI, MCP, HTTP, and OpenAPI.

OpenConnector – AI Agent 的統一連接器閘道

是什麼 – 一個開源執行環境，讓 AI Agent（或任何應用程式）可以呼叫數千種第三方服務（GitHub, Gmail, Notion, Slack, BigQuery, …）而無需 Agent 本身管理 OAuth 流程或 API 金鑰。它透過單一的 HTTP/OpenAPI 端點、CLI 或 MCP 協定，提供包含 1,000+ 提供者 與 10,000+ 預建 Action 的目錄。

為什麼重要 – 現代由 LLM 驅動的助手需要可靠且可稽核的工具存取權限。OpenConnector 提供了一個持久的「憑證邊界」：Agent 僅接收元數據（metadata）與結果，而實際的秘密資訊（secrets）則保留在受控的執行環境中。

核心能力

Feature	What you get
Provider catalog	為熱門 SaaS 產品（GitHub, Gmail, Supabase, etc.）提供現成的定義，包含請求/回應架構（schemas）與必要的權限範圍（scopes）。
Credential handling	內建對 API keys、OAuth2（包含 token refresh）、自定義憑證以及完全無需驗證的服務支援。
Inspectable Action contracts	每個 Action 都附帶 JSON schema、必要的權限範圍以及延遲載入的執行器來源，使除錯與政策執行變得容易。
Runtime controls	針對每個連接的 token、權限範圍限制、允許/封鎖政策、暫時性檔案傳輸以及脫敏的執行日誌。
Multiple deployment models	• Managed SaaS on OOMOL (no infra to run)
• Cloudflare Workers (D1, R2, static assets)
• Docker / Node.js (SQLite or PostgreSQL, optional S3-compatible storage)
• Kubernetes Helm chart
• Fly.io Docker host
Developer tooling	• Connector SDK (thin TypeScript HTTP client)
• oo CLI (local relay for searching, inspecting, and running Actions)
• MCP endpoint for agents that speak the MCP protocol
• OpenAPI spec (`/openapi.json`) for any HTTP client
Web console	UI 用於瀏覽提供者、配置憑證、建立執行環境 token、查看日誌以及測試 Action。

典型使用場景

AI-assistant platforms 需要一種可重複使用且可稽核的方式來呼叫使用者授權的服務（例如：一個可以讀取使用者 Gmail 或寫入 Notion 的聊天機器人）。
Enterprise SaaS products 希望在不將所有第三方憑證儲存在自家資料庫的情況下，嵌入「Agent 驅動」的工作流。
Developer teams 正在建立自定義 Agent，基於合規性或數據主權考量，偏好使用自託管執行環境。
Prototypers 希望快速擁有一個「類似 Pipedream」的 Action 目錄，而無需撰寫 OAuth 流程。

入門指南（最快路徑）

執行 Docker 映像檔

docker compose up   # pulls ghcr.io/oomol-lab/open-connector:latest

開啟本地控制台：http://localhost:3000（或開發者控制台 http://localhost:5173）。

測試一個無需驗證的 Action：

curl -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
     -H 'content-type: application/json' -d '{"input":{}}'

透過控制台或如 README 中所示的簡單 PUT 請求來連接真實的提供者（例如：GitHub）。
使用 Agent 程式碼中的 Connector SDK 或 oo CLI 來探索 Action 並呼叫它們。

專案資產

Source: https://github.com/oomol-lab/open-connector
License: Apache-2.0 (僅限專案程式碼；不包含第三方提供者資產)。
Community: 歡迎透過 pull requests 進行貢獻；關於提供者新增指南，請參閱 CONTRIBUTING.md。

摘要 (TL;DR)

OpenConnector 是一個可自託管（或 SaaS 託管）的閘道，它為 AI Agent 集中化管理 OAuth 與 API-key，透過乾淨的 HTTP/OpenAPI 介面，提供海量的預建 Action 目錄。它專為任何人建立 LLM 驅動的工具時，需要安全且可稽核的服務存取權限時而設計。