# open-connector-pro 🌐

![Open Connector Pro Banner](assets/banner.png)

> **Next-Generation Unified AI Agent SaaS Connector & Multi-Provider Gateway**  
> Connect AI agents to 1,000+ SaaS platforms, vector databases, and 500+ LLM models via standard Model Context Protocol (MCP), REST API, and CLI interfaces. Built for high resilience, zero-trust security, and real-time metering.

---

## 🚀 Key Features

- **Universal MCP & REST Connector Bridge**: Native bidirectional translation between MCP tool definitions (`listMcpTools`), OpenAPI specs, and HTTP endpoints.
- **Multi-Provider LLM Router & Circuit Breaker**: Intelligent request dispatching across AI providers (OpenAI, Anthropic, Gemini, Groq, Ollama) with latency-based auto-failover, exponential retry, and circuit breaker protection (`lib/router.js`).
- **Zero-Trust Encrypted Credential Vault**: AES-256-CBC encrypted credential manager supporting granular agent scope permissions, token rotation, and immutable audit logs (`lib/vault.js`).
- **Sliding-Window Rate Limiter & Token Metering Engine**: Precision sliding-window rate limiting and per-agent token usage tracking for prompt/completion metering (`lib/metering.js`).
- **Interactive Browser Playground Studio**: Single-file visual dashboard (`demo/index.html`) featuring live MCP tool registry, route inspector, and real-time circuit state telemetry.
- **Strict Automated Quality Gate**: Comprehensive inspection engine auditing tool schema completeness, encryption status, rate limiting rules, and circuit breaker health (`lib/qualityGate.js`).
- **Checkpointed Auto-Installer**: Includes executable `./install.sh --resume` script for error recovery during setup.

---

## 📊 Comparison & Superiority

| Feature | 🌐 **open-connector-pro** | 📦 **Zapier / Make** | 🐍 **LangChain Connectors** |
| :--- | :--- | :--- | :--- |
| **Dependencies** | 🌟 **0 External Dependencies** | Proprietary closed SaaS | Complex Python dependency chain |
| **Security** | 🛡️ **AES-256-CBC Zero-Trust Vault**| Cloud-hosted third party | Plaintext env vars |
| **Resilience** | ⚡ **Built-in Circuit Breaker** | Basic HTTP retries | Standard exceptions |
| **Auto-Installer** | 🔄 **Checkpoint Resume (`./install.sh`)**| SaaS subscription | Manual pip setup |

---

## 🏗️ Architecture

![Open Connector Pro Architecture](assets/architecture.png)

---

## ⚡ Quick Start

```bash
git clone https://github.com/tonysheesh/open-connector-pro.git
cd open-connector-pro

# Run checkpointed installer
./install.sh
```

---

## 🧪 Testing

```bash
npm test
```

---

## 🗺️ Roadmap

- 🌐 OAuth2 auto-refresh flow manager for enterprise SaaS integrations
- 📊 Grafana / Prometheus metrics exporter endpoint
- 🔒 Hardware Security Module (HSM) key storage adapter
- 🤖 Auto-discovery engine for local MCP servers on network
- ⚡ WebAssembly request router for high-throughput gateway proxying

---

## 📜 License

MIT License © 2026 [tonysheesh](https://github.com/tonysheesh)