oomol-lab/open-connector

OpenConnector – AI 代理使用外部服务的网关

概述 | OpenConnector 是一个开源“连接器网关”，允许 AI 代理（或任何应用）调用数千种第三方服务——如 GitHub、Gmail、Notion、Slack、BigQuery 等——而无需将用户凭据直接暴露给代理。它提供了 1,000 多个提供商和 10,000 多个预构建操作（单个 API 调用）的目录，代理可以发现、检查并调用这些操作。

为什么对 AI 很重要 | 现代基于 LLM 的代理需要处理真实世界的数据并执行任务（发送电子邮件、更新电子表格、查询数据库）。为每个代理管理 OAuth 流程、API 密钥和策略执行既复杂又存在安全风险。OpenConnector 集中处理凭据，并提供稳定、可检查的 API，代理可以安全调用。

主要组件

• 连接器目录 – 提供共享的提供商和操作注册表，包含请求/响应模式、所需作用域和可执行代码。
• 运行时网关 – 一个 Node.js/Cloudflare 兼容服务，用于存储凭据、强制执行策略、记录运行日志并执行操作。
• 开发者工具 –
  • 连接器 SDK（TypeScript 客户端），用于编程使用。
  • oo CLI，用于本地代理中继和调试。
  • MCP 端点，支持理解 MCP 协议的代理。
  • 直接 HTTP/OpenAPI 访问。
• Web 控制台 – 用于浏览目录、配置凭据、创建运行时令牌和检查日志的 UI。

---

部署选项

• 托管（OOMOL） – 托管的 OAuth 应用和运行时，无需自己管理基础设施。
• 自托管 – Docker Compose 或纯 Node.js；默认使用 SQLite 或 PostgreSQL 存储状态；文件传输可使用 S3 兼容存储。
• 平台无关 – 可运行在 Cloudflare Workers、Fly.io、RepoCloud、nibrun、NEXUS AI 等平台。

---

典型工作流程

1. 连接用户账户 – 通过 API 密钥或 OAuth2（例如，PUT /api/connections/github）。
2. 代理发现操作 – 查询目录或 OpenAPI 规范，找到 github.get_current_user。
3. 代理调用操作 – 使用运行时令牌调用 POST /v1/actions/github.get_current_user。
4. 网关执行 – 使用存储的凭据，应用任何允许/阻止策略，记录运行日志，并返回结果。

---

适用的用户

• 构建需要可重用、可审计访问用户 SaaS 工具的 AI 驱动产品的团队。
• 希望无需编写单独 OAuth 集成即可获得即插即用操作目录的开发者。
• 希望将凭据保留在受控运行时之后，同时允许代理执行操作的组织。

---

快速开始

# 快速本地启动（Docker Compose 拉取预构建镜像）
 docker compose up
 # 使用免认证操作验证
 curl -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
      -H 'content-type: application/json' -d '{"input":{}}'

然后打开 http://localhost:3000 访问控制台，或打开 http://localhost:3000/docs 查看 OpenAPI 参考。

许可证与社区

• 代码采用 Apache-2.0 许可证；第三方提供商资源不在此列。
• 欢迎贡献（参见 CONTRIBUTING.md），并遵循友善的行为准则。

OpenConnector 因此充当了 LLM 代理安全、可靠地与庞大的 Web 服务生态系统交互的管道。