sncro.net MCP Server

resmi

Yapay zeka asistanları için canlı tarayıcı hata ayıklama — DOM, konsol, ağ, MCP üzerinden.

Dokümantasyon

sncro-relay

sncro'nun açık kaynaklı bileşenleri — MCP rölesi, tarayıcı tarafı ajanı ve yapay zeka kodlama asistanlarının canlı bir tarayıcıyı incelemesini sağlayan çerçeve eklentileri.

Bu depoda neler var

Yol	İçerik
`relay/`	Bir MCP sunucusu ve agent.js için uzun yoklama uç noktaları sunan FastAPI uygulaması
`relay/static/agent.js`	Ara yazılım tarafından enjekte edilen tarayıcı tarafı betik; konsol ve DOM verilerini röleye iletir
`middleware/sncro_middleware.py`	FastAPI / Starlette eklentisi — FastAPI uygulamaları için tak-çalıştır ara yazılım
`middleware/sncro_flask.py`	Flask eklentisi — Flask uygulamaları için tak-çalıştır ara yazılım
`trysncro/`	`try.sncro.net` — sncro'yu uçtan uca test etmek için bilerek bozulmuş bir demo uygulama

Nasıl çalışır

 ┌──────────────┐    MCP     ┌──────────┐   long-poll   ┌─────────────┐
 │ Claude Code  │──tools────▶│  relay   │◀──────────────│  agent.js   │
 │ (or other    │            │ (relay/) │   snapshots   │ (injected   │
 │  MCP client) │◀──results──│          │──────────────▶│  by plugin) │
 └──────────────┘            └──────────┘               └─────────────┘
                                                              ▲
                                                              │ same-origin
                                                              │ cookies
                                                       ┌─────────────┐
                                                       │  your app   │
                                                       │ (plugin is  │
                                                       │  installed) │
                                                       └─────────────┘

Claude create_session (MCP aracı) çağırır → röle 9 haneli bir oturum anahtarı ve URL döndürür
Kullanıcı, uygulamasının çalıştığı tarayıcıda URL'yi ziyaret eder → "sncro hata ayıklamaya izin verilsin mi?" ile onaylar
Eklenti bir çerez bırakır, sonraki HTML yanıtlarına o kaynakta agent.js enjekte edilir
agent.js temel verileri (konsol, hatalar) iletir ve isteğe bağlı sorgular için uzun yoklama yapar (query_element, get_page_snapshot, vb.)

sncro'yu kullanma

Çoğu kullanıcının röleyi kendisinin çalıştırmasına gerek yoktur — relay.sncro.net adresindeki barındırılan sürüm ücretsiz kullanıma uygundur. Projenizi sncro.net adresinde kaydedin ve proje anahtarınızı alın.

FastAPI: middleware/sncro_middleware.py dosyasını projenize ekleyin, ardından:

from middleware.sncro_middleware import SncroMiddleware, sncro_routes

app = FastAPI(debug=True)  # sncro only loads when debug=True
if app.debug:
    app.include_router(sncro_routes)
    app.add_middleware(SncroMiddleware, relay_url="https://relay.sncro.net")

Flask: middleware/sncro_flask.py dosyasını projenize ekleyin, ardından:

from sncro_flask import init_sncro

app = Flask(__name__)
if app.debug:
    init_sncro(app, relay_url="https://relay.sncro.net")

Her iki ara yazılım da yalnızca hata ayıklama modunda etkinleşir — üretim ortamında sıfır ek yük.

Katkıda bulunma

Yeni çerçeve eklentilerini seviyoruz. CONTRIBUTING.md bir eklentinin yapması gerekenlerin tam şartnamesini içerir — çerezler, rotalar, güvenlik başlıkları — ayrıca test şablonu da bulunur. Django, Rails, Express, Next.js, ASP.NET, Go — hepsi kabul edilir.

Hata raporları ve güvenlik sorunları: bkz. SECURITY.md.

Lisans

MIT. Bkz. LICENSE.

sncro.net adresindeki gösterge paneli (proje yönetimi, faturalandırma, yönetici) ayrı bir özel depoda bulunur.