sncro의 오픈 소스 구성 요소 — MCP 릴레이, 브라우저 측 에이전트, 그리고 AI 코딩 어시스턴트가 라이브 브라우저를 검사할 수 있게 해주는 프레임워크 플러그인입니다.
경로 | 내용 |
| MCP 서버와 agent.js를 위한 롱폴링 엔드포인트를 노출하는 FastAPI 앱 |
| 미들웨어에 의해 주입되는 브라우저 측 스크립트; 콘솔 및 DOM 데이터를 릴레이로 전송 |
| FastAPI / Starlette 플러그인 — FastAPI 앱을 위한 드롭인 미들웨어 |
| Flask 플러그인 — Flask 앱을 위한 드롭인 미들웨어 |
|
|
Related MCP server: agnt
┌──────────────┐ 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 도구)을 호출 → 릴레이가 9자리 세션 키와 URL을 반환
사용자가 앱이 실행 중인 브라우저에서 해당 URL을 방문 → "sncro 디버깅을 허용하시겠습니까?"를 통해 확인
플러그인이 쿠키를 설정하고, 해당 오리진의 후속 HTML 응답에 agent.js가 주입됨
agent.js가 기본 데이터(콘솔, 오류)를 전송하고 온디맨드 쿼리(query_element, get_page_snapshot 등)를 위해 롱폴링 수행
대부분의 사용자는 직접 릴레이를 실행할 필요가 없습니다. relay.sncro.net에서 호스팅되는 버전은 무료 티어에 적합합니다. sncro.net에서 프로젝트를 등록하고 프로젝트 키를 받으세요.
FastAPI: middleware/sncro_middleware.py를 프로젝트에 넣은 후:
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를 프로젝트에 넣은 후:
from sncro_flask import init_sncro
app = Flask(__name__)
if app.debug:
init_sncro(app, relay_url="https://relay.sncro.net")두 미들웨어 모두 디버그 모드에서만 활성화되므로 프로덕션 환경에서는 오버헤드가 전혀 없습니다.
새로운 프레임워크 플러그인을 환영합니다. CONTRIBUTING.md에는 플러그인이 수행해야 할 작업(쿠키, 라우트, 보안 헤더)과 테스트 템플릿에 대한 전체 사양이 포함되어 있습니다. Django, Rails, Express, Next.js, ASP.NET, Go 등 무엇이든 환영합니다.
버그 보고 및 보안 문제는 SECURITY.md를 참조하세요.
MIT. LICENSE를 참조하세요.
sncro.net의 대시보드(프로젝트 관리, 결제, 관리자)는 별도의 독점 저장소에 있습니다.
This server cannot be deployed
Hosted browser for AI agents: screenshots, post-JS DOM, console, WCAG. No install, no API key.
Monitoring + status pages set up by talking to Claude. Auto-detects 30+ SDKs and your URLs.
AI visibility & recommendation monitoring for ChatGPT, Claude, Gemini & Perplexity.
Screenshot, PDF and HTML-to-image rendering API so Claude and Cursor can see any web page.
