oomol-lab/open-connector

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

OpenConnector – 为 AI 代理提供统一连接的网关

是什么 – 一个开源运行时，允许 AI 代理（或任何应用程序）调用数千种第三方服务（GitHub、Gmail、Notion、Slack、BigQuery 等），而无需代理自行管理 OAuth 流程或 API 密钥。它通过单一的 HTTP/OpenAPI 端点、CLI 或 MCP 协议，提供超过 1 000 个服务提供商 和 10 000 个预构建操作 的目录。

为何重要 – 现代基于大语言模型（LLM）的助手需要可靠且可审计的方式来访问用户已使用的工具。OpenConnector 提供了一个持久的“凭证边界”：代理仅接收元数据和结果，而实际的敏感信息则保留在受控的运行时环境中。

核心功能

功能	你将获得
服务提供商目录	针对主流 SaaS 产品（GitHub、Gmail、Supabase 等）的现成定义，包含请求/响应模式和所需权限范围。
凭证管理	内置对 API 密钥、OAuth2（含令牌刷新）、自定义凭证以及完全无认证服务的支持。
可检查的操作契约	每个操作都附带 JSON 模式、所需权限范围和懒加载执行器源代码，便于调试和策略执行。
运行时控制	每连接令牌、权限范围限制、允许/阻止策略、临时文件传输以及脱敏运行日志。
多种部署模式	• 托管 SaaS，在 OOMOL 上运行（无需自行运维基础设施）
• Cloudflare Workers（D1、R2、静态资源）
• Docker / Node.js（SQLite 或 PostgreSQL，可选 S3 兼容存储）
• Kubernetes Helm 图表
• Fly.io Docker 主机
开发者工具	• Connector SDK（轻量级 TypeScript HTTP 客户端）
• oo CLI（本地中继，用于搜索、检查和运行操作）
• MCP 端点，供支持 MCP 协议的代理使用
• OpenAPI 规范（`/openapi.json`），适用于任何 HTTP 客户端
Web 控制台	用于浏览服务提供商、配置凭证、创建运行时令牌、查看日志和测试操作的用户界面。

典型应用场景

AI 助手平台，需要一种可复用、可审计的方式调用用户授权的服务（例如，一个能读取用户 Gmail 或写入 Notion 的聊天机器人）。
企业级 SaaS 产品，希望嵌入“代理驱动”的工作流，而无需将每个第三方凭证存储在自己的数据库中。
开发团队，构建自定义代理时，出于合规或数据主权考虑，更倾向于自托管运行时。
原型开发者，希望快速获得类似 Pipedream 的操作目录，而无需编写 OAuth 代码。

快速入门（最快路径）

运行 Docker 镜像

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

打开本地控制台：http://localhost:3000（或开发控制台 http://localhost:5173）。

测试一个无需认证的操作：

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

通过控制台或简单的 PUT 请求（如 README 中所示）连接真实服务（例如 GitHub）。
在你的代理代码中使用 Connector SDK 或 oo CLI 来发现操作并调用它们。

项目地址

源码： https://github.com/oomol-lab/open-connector
许可证： Apache-2.0（仅项目代码；第三方服务资产不在此范围内）。
社区：欢迎通过拉取请求贡献；详见 CONTRIBUTING.md 了解添加服务的指南。

简要总结

OpenConnector 是一个可自托管（或由 SaaS 托管）的网关，集中管理 AI 代理的 OAuth 和 API 密钥，通过简洁的 HTTP/OpenAPI 接口暴露海量即用型操作目录。它专为所有需要安全、可审计地访问用户已依赖的众多 SaaS 服务的 LLM 驱动工具的开发者而设计。