sncro

io.github.scottconfusedgorilla由 GitHub 账号 scottconfusedgorilla 发布v0.9.4更新于 Oct 27, 2026

Live browser debugging for AI assistants — DOM, console, network via MCP.

已验证Streamable HTTP可网页运行浏览器自动化开发者工具

概览

AI 生成的概览

远程 MCP 中继服务，让 AI 助手在调试 Web 应用时查看实时浏览器会话的 DOM、控制台输出和网络活动。

可以做什么
  • 创建调试会话，获得会话密钥和需要在浏览器中打开的 URL
  • 检查实时页面：查询元素、获取页面快照
  • 读取浏览器推送的控制台输出和错误信息
  • 配合已安装 sncro 中间件的 FastAPI 或 Flask 应用使用
适用场景
适合助手协助调试正在运行的 Web 应用、需要看到浏览器实际渲染内容、日志或请求而不是仅凭源码推测的场景。适用于可添加 sncro 中间件并以调试模式运行的 FastAPI 或 Flask 项目。
运行要求
远程 MCP 端点 relay.sncro.net（也可自行部署中继）。需在 sncro.net 注册项目并获取项目密钥，并在以调试模式运行的 FastAPI 或 Flask 应用中添加 sncro 中间件。用户需在浏览器中打开会话 URL 并确认调试授权。
安装前请注意
浏览器端代理会把用户应用的页面内容和控制台数据推送到中继，数据会离开本机。中间件会在应用源上注入脚本并设置 Cookie，应仅在调试模式下启用。需要项目密钥，请妥善保管。

安装

在 SourceWeft 中

  1. 打开 控制台中的 sncro，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.scottconfusedgorilla%2Fsncro/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "sncro": {
      "type": "http",
      "url": "https://relay.sncro.net/tools/mcp"
    }
  }
}

README

sncro-relay

Open-source components of sncro — the MCP relay, the browser-side agent, and the framework plugins that let AI coding assistants inspect a live browser.

What this repo contains

PathWhat
relay/FastAPI app that exposes an MCP server plus long-poll endpoints for agent.js
relay/static/agent.jsBrowser-side script injected by the middleware; pushes console + DOM data to the relay
middleware/sncro_middleware.pyFastAPI / Starlette plugin — drop-in middleware for FastAPI apps
middleware/sncro_flask.pyFlask plugin — drop-in middleware for Flask apps
trysncro/try.sncro.net — a deliberately-broken demo app for exercising sncro end-to-end

How it works

 ┌──────────────┐    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) │                                                       └─────────────┘
  1. Claude calls create_session (MCP tool) → relay returns a 9-digit session key + URL
  2. User visits the URL in the browser where their app is running → confirms via "Allow sncro debugging?"
  3. The plugin drops a cookie, agent.js is injected into subsequent HTML responses on that origin
  4. agent.js pushes baseline data (console, errors) and long-polls for on-demand queries (query_element, get_page_snapshot, etc.)

Using sncro

Most users don't need to run the relay yourself — the hosted version at relay.sncro.net is free-tier friendly. Register your project at sncro.net and grab your project key.

FastAPI: drop middleware/sncro_middleware.py into your project, then:

python
from middleware.sncro_middleware import SncroMiddleware, sncro_routes
app = FastAPI(debug=True)  # sncro only loads when debug=Trueif app.debug:    app.include_router(sncro_routes)    app.add_middleware(SncroMiddleware, relay_url="https://relay.sncro.net")

Flask: drop middleware/sncro_flask.py into your project, then:

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

Both middlewares only activate in debug mode — zero overhead in production.

Contributing

We love new framework plugins. CONTRIBUTING.md has the full spec for what a plugin must do — cookies, routes, security headers — plus the test template. Django, Rails, Express, Next.js, ASP.NET, Go — all welcome.

Bug reports and security issues: see SECURITY.md.

License

MIT. See LICENSE.

The dashboard at sncro.net (project management, billing, admin) lives in a separate proprietary repo.

来源：README.md，提交 9576cd2

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v0.9.4最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分