Skip to content
This repository was archived by the owner on Oct 31, 2026. It is now read-only.
dario-cositorePublic archive

About

Turn any webpage into a production-ready MCP connector — works with Claude, Cursor, Windsurf, and any MCP-compatible AI agent.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

OpenConnect

Turn any webpage into a production-ready MCP connector — works with Claude, Cursor, Windsurf, and any MCP-compatible AI agent.

License: BSL 1.1 Server Extension Phases

What is OpenConnect?

OpenConnect is an open (source-available) platform that lets anyone generate MCP (Model Context Protocol) connectors for any website using a Chrome extension and an AI-powered execution engine.

[Chrome Extension]  →  Generates connector JSON via AI  →  Pushes to Hub
       ↓                                                        ↓
[Page Analyzer]    →  Playwright DOM steps               [MCP Server]
       ↓                                                        ↓
[AI Connector Arch.] → Tools with self-healing selectors → [SSE/Streamable]
                                                               ↓
                                                      [Claude/Cursor/Windsurf]

Key Features

  • Chrome Extension (v1.4.0) — One-click connector generation from any page
  • 3-Tier Generation — Free (baked key), Premium (server-side GPT-4o), Custom (BYOK)
  • Execution Engine — Playwright-powered DOM automation with self-healing selectors
  • 20+ DOM Step Actions — navigate, fill, click, extract, file upload/download, multi-tab, screenshots
  • Gamification — Points, leaderboards, badges, daily caps, anti-gaming
  • Auth System — Email/password, Google, GitHub, X OAuth, httpOnly cookies, JWT
  • Hub Website — Landing page, connector directory, public profiles, changelog
  • Dashboard SPA — User dashboard with connector management, credits, settings
  • 18/22 Phases Complete — Core platform, execution engine, analytics, auth, gamification

Project Structure

OpenConnect/
├── extension/          # Chrome extension (MV3)
│   ├── background.js   # Service worker: 3-tier generation, event tracking
│   ├── content.js      # Page analyzer: DOM scanning, e-commerce detection
│   ├── content_sync.js # Dashboard ↔ extension token relay
│   ├── popup.html/js   # Main UI: auth, tier selector, result card, library
│   ├── options.html/js # Settings: API key, model, storage
│   ├── styles.css      # Extension styles
│   ├── manifest.json   # MV3 manifest
│   └── icons/          # Extension icons (16, 48, 128px)
│
├── server/             # FastAPI backend + Playwright execution engine
│   ├── mcp_connector_server.py  # Main server (v2.15.1) — 5880 lines
│   ├── billing.py      # Tier-based quota tracking (starter/pro/unlimited)
│   ├── Dockerfile      # Docker image with Playwright Chromium
│   ├── docker-compose.yml
│   ├── Caddyfile       # Reverse proxy config (SSE support)
│   ├── deploy.sh       # Hetzner VPS deploy script
│   ├── openconnect.service  # Systemd service
│   ├── requirements.txt
│   ├── .env.example
│   ├── backup.sh
│   ├── data/           # Persistent JSON data (connectors, users, points)
│   └── tests/          # pytest suite (140 tests)
│       ├── conftest.py
│       ├── test_core.py
│       ├── test_auth_edge_cases.py
│       ├── test_integration.py
│       ├── test_phase1.py
│       └── test_phase2.py
│
├── web/                # Static sites (Cloudflare Pages)
│   ├── hub/            # Landing page (hub.dariocositore.com)
│   │   ├── index.html  # Hero, connector directory, leaderboard
│   │   ├── connectors/ # Public connector directory
│   │   ├── docs/       # Documentation pages
│   │   ├── changelog/
│   │   ├── pricing/
│   │   ├── privacy/
│   │   ├── terms/
│   │   └── assets/     # CSS, JS, images
│   └── app/            # Dashboard SPA (app.dariocositore.com)
│       ├── index.html  # Auth gate
│       ├── login.html  # Login/register forms
│       ├── dashboard/  # Main dashboard (connectors, credits, points)
│       ├── auth/       # OAuth callback, email verification
│       ├── users/      # Public profiles
│       └── assets/     # CSS, JS (auth.js, app.js)
│
├── docs/               # Project documentation
│   ├── OpenConnect-Deployment-Guide.md
│   ├── EXECUTION-ENGINE.md
│   ├── GAMIFICATION.md
│   ├── RESUME.md
│   ├── REPO-GUIDE.md
│   └── plan.md
│
├── .github/            # GitHub config
│   ├── workflows/      # CI/CD
│   └── ISSUE_TEMPLATE/ # Bug report, feature request
│
├── LICENSE.md          # Business Source License 1.1
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
└── README.md           # This file

Quick Start

Chrome Extension (Development)

cd extension/
# Nothing to build — it's vanilla JS/HTML/CSS
# Go to chrome://extensions → Enable Developer mode → Load unpacked → Select this folder

Local Server

cd server/
cp .env.example .env
# Edit .env with your settings
pip install -r requirements.txt
python -m uvicorn mcp_connector_server:app --reload --port 8080

Run Tests

cd server/
pip install -r requirements.txt pytest pytest-asyncio
python -m pytest tests/ -v

Docker Deploy

cd server/
docker compose up --build

Production Deploy (Hetzner VPS)

cd server/
bash deploy.sh your-domain.com

API Reference

Endpoint Method Auth Description
/ GET None Health check
{id}/sse GET None MCP tool definitions via SSE
execute/{id}/{tool} POST JWT Execute a connector tool (Playwright)
connectors POST Admin Create/update connector
connectors GET Admin List all connectors
connectors/public GET None Public connector list (with filters)
connectors/public/{id} GET None Single connector detail
connectors/push POST None* Push from extension (*email verified)
connectors/generate POST JWT AI-powered premium generation
auth/register POST None User registration
auth/login POST None Login → httpOnly cookies
auth/me GET Cookie Current user profile
auth/logout POST Cookie Logout
auth/forgot-password POST None Send reset email
auth/reset-password POST Token Reset password
auth/oauth/google Redirect None Google OAuth
auth/oauth/twitter Redirect None X OAuth
auth/oauth/github Redirect None GitHub OAuth
leaderboard GET None Global rankings
users/{id} GET None Public user profile
users/{id}/badges GET None User badges
points/balance GET JWT Current user points
api/events POST None Analytics event tracking

Tier System

Tier Executions/Day Price
Free 10 $0
Starter 500 Waitlist
Pro 1,500 Waitlist
Unlimited 5,000 Waitlist

Free tier gets 50 connector generations per account (baked-in OpenRouter key).

Connector Schema

Connectors are JSON documents defining MCP tools with DOM automation steps:

{
  "connector_id": "example-shopping",
  "connector_name": "Example Shopping Assistant",
  "description": "Search and browse products on example.com",
  "session_mode": "stateless",
  "tools": [{
    "name": "example_search",
    "description": "Search for products",
    "inputSchema": {
      "type": "object",
      "properties": { "query": { "type": "string" } },
      "required": ["query"]
    },
    "dom_steps": [
      { "action": "navigate", "url": "https://example.com/search?q={query}" },
      { "action": "wait_for_selector", "selector": ".results", "timeout_ms": 5000 },
      { "action": "extract", "selector": ".results", "as": "results" }
    ]
  }]
}

Contributing

See CONTRIBUTING.md for guidelines. All contributors must sign the Contributor License Agreement (CLA) before their PRs can be merged.

License

This project is licensed under the Business Source License 1.1. You may use, modify, and contribute to this project for non-commercial purposes. On May 24, 2030, this license converts to Apache License 2.0.

Copyright 2026 Dario Cositore.

About

Turn any webpage into a production-ready MCP connector — works with Claude, Cursor, Windsurf, and any MCP-compatible AI agent.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages