io.github.CloudCorpRecords/browserstage

السجل الرسمي البحث والويب

Automate a browser with accessibility snapshots: navigate, click, type, fill and wait.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @reneturcios/browserstage
Claude Code
claude mcp add browserstage -- npx -y @reneturcios/browserstage@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "browserstage": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/browserstage@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/browserstage:0.1.0
Claude Code
claude mcp add browserstage -- docker run -i --rm ghcr.io/cloudcorprecords/browserstage:0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "browserstage": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/browserstage:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. browserstage
  2. Install
  3. CLI
  4. MCP tools
  5. Docker
  6. Development

browserstage

Snapshot-driven browser automation as a CLI and a stdio MCP server in one bin. Navigate, capture an accessibility snapshot of the page, then act on elements by the references in that snapshot: click, hover, drag, drop, type, fill whole forms, select options, press keys, upload files and handle dialogs. Console messages and network requests are readable tools, and tabs can be listed, created, closed and selected.

The browser sits behind an injectable executor interface (StageBrowser in src/types.ts). This package bundles no browser and downloads none: with no executor configured, browser commands fail with a clear "Browser unavailable" error. Deployments inject a Playwright-compatible executor to drive a real browser. The browser_run_code_unsafe tool runs arbitrary code against the page in the original design and keeps that name and its warning here: only enable it where you would run arbitrary code yourself.

Install

npx -y @reneturcios/browserstage mcp

CLI

browserstage mcp
browserstage navigate <url>
browserstage snapshot
browserstage press <key>
browserstage resize <width> <height>
browserstage --version

Exit codes: 0 success, 1 browser error, 2 usage error.

MCP tools

24 core tools: browser_navigate, browser_navigate_back, browser_snapshot, browser_find, browser_click, browser_hover, browser_drag, browser_drop, browser_select_option, browser_type, browser_press_key, browser_fill_form, browser_take_screenshot, browser_run_code_unsafe, browser_evaluate, browser_wait_for, browser_handle_dialog, browser_file_upload, browser_console_messages, browser_network_requests, browser_network_request, browser_tabs, browser_close, browser_resize.

MCP client config:

{
  "mcpServers": {
    "browserstage": {
      "command": "npx",
      "args": ["-y", "@reneturcios/browserstage", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/browserstage          # MCP server
docker run --rm ghcr.io/cloudcorprecords/browserstage --version

Development

npm install
npm run build
npm test

MIT license.

الأسئلة الشائعة

ما هو io.github.CloudCorpRecords/browserstage؟

Automate a browser with accessibility snapshots: navigate, click, type, fill and wait.

كيف أثبّت io.github.CloudCorpRecords/browserstage؟

يعمل على جهازك. في Claude Code: claude mcp add browserstage -- npx -y @reneturcios/browserstage@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/browserstage إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/browserstage مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CloudCorpRecords/browserstage؟

ينشره CloudCorpRecords. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.