{"_id":"@argus-browser/mcp-server","_rev":"4-1fc3b2bb2f5d3d62191d550d69c6e83f","name":"@argus-browser/mcp-server","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@argus-browser/mcp-server","version":"0.1.0","_id":"@argus-browser/mcp-server@0.1.0","maintainers":[{"name":"quicknet123","email":"quicknet123@gmail.com"}],"bin":{"argus-mcp":"dist/index.js"},"dist":{"shasum":"2f22bb79797e1d8a9edfdc15ef4f95976007613c","tarball":"https://registry.npmjs.org/@argus-browser/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":5,"integrity":"sha512-qqoP667Uwu6YcyivGDBjialeCw137EYubh+dbQ+da9Od4guqvh0WdunbDZNAtiS5jqGYlI5VKi6r8XEU6B2orw==","signatures":[{"sig":"MEUCIGsF8i1Ot/iilfijSWw4NYycO4tOXVtAGmh8v0dqUzvbAiEAw3i7wGnbstD4NovwkFaq92Yni26UNsjL69ln70UWmcE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":750462},"type":"module","engines":{"node":">=18"},"gitHead":"f6a2ebcabb1552317af2bf34a44cb5a714f4ce59","scripts":{"test":"tsx --test tests/stdio-mcp.test.ts","build":"esbuild src/index.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/index.js","start":"tsx src/index.ts","test:live":"tsx --test tests/live-mcp-smoke.test.ts","prepublishOnly":"pnpm build && pnpm test"},"_npmUser":{"name":"quicknet123","email":"quicknet123@gmail.com"},"_npmVersion":"11.12.1","description":"Argus Browser MCP server (stdio) — drive antidetect browser profiles from Claude Desktop / Cursor via natural language. Bridges to the desktop Local API (AdsPower-compatible) over HTTP.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","zod":"^3.23.8","esbuild":"^0.25.0","express":"^5.2.1","typescript":"^5.7.0","@types/node":"^20.0.0","@types/express":"^5.0.0","playwright-core":"^1.49.0","@argus-browser/shared":"workspace:*","@modelcontextprotocol/sdk":"^1.7.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1783837578759_0.2987459342358254","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@argus-browser/mcp-server","version":"0.1.1","_id":"@argus-browser/mcp-server@0.1.1","maintainers":[{"name":"quicknet123","email":"quicknet123@gmail.com"}],"bin":{"argus-mcp":"dist/index.js"},"dist":{"shasum":"9ae30091137348ae790a62ddaca6af8c1ec80f5a","tarball":"https://registry.npmjs.org/@argus-browser/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":3,"integrity":"sha512-XXyHpaSzC8F3pQHDTMglZkfteXRfnBf4UEShjgn8oaMPmFtfNc2mnQsiDqV90yf6S3HQx/LJaYfA5Wm/inH9EQ==","signatures":[{"sig":"MEUCIBaSmN14I+QE1x5WHMVOR4LhWqrn7aPeLP5UBFdqXYxxAiEA91iOANGL+fnOV33khsC+7svrnVX9RRcMwf3wxFJhaQc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":746703},"type":"module","engines":{"node":">=18"},"gitHead":"aa9ff7df549b6a6518ec1569508a4c052b23b951","scripts":{"test":"tsx --test tests/stdio-mcp.test.ts","build":"rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/index.js","start":"tsx src/index.ts","test:live":"tsx --test tests/live-mcp-smoke.test.ts","prepublishOnly":"pnpm build && pnpm test"},"_npmUser":{"name":"quicknet123","email":"quicknet123@gmail.com"},"_npmVersion":"11.12.1","description":"Argus Browser MCP server (stdio) — drive antidetect browser profiles from Claude Desktop / Cursor via natural language. Bridges to the desktop Local API (AdsPower-compatible) over HTTP.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","zod":"^3.23.8","esbuild":"^0.25.0","express":"^5.2.1","typescript":"^5.7.0","@types/node":"^20.0.0","@types/express":"^5.0.0","playwright-core":"^1.49.0","@argus-browser/shared":"workspace:*","@modelcontextprotocol/sdk":"^1.7.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1783838152959_0.8993564321229068","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@argus-browser/mcp-server","version":"0.2.0","_id":"@argus-browser/mcp-server@0.2.0","maintainers":[{"name":"quicknet123","email":"quicknet123@gmail.com"}],"bin":{"argus-mcp":"dist/index.js"},"dist":{"shasum":"7fc6b4761e2eb8fa7ebe34b6b78b3e515b4fab21","tarball":"https://registry.npmjs.org/@argus-browser/mcp-server/-/mcp-server-0.2.0.tgz","fileCount":3,"integrity":"sha512-dfTnks8ZsJK5k4ijxE93D9bgmZniTzsTe1D/lGSD2mr3hCZx6k6WD26dkWBBFliC+2nCkLF2D4aUQYN43cr1uQ==","signatures":[{"sig":"MEYCIQCLa2OWVf1PcxwAn25S4Rcq2e23Urm4bUM+rAqdl69lSQIhAJMu/VBCLJH7b4oKup/IQucw39C+2Ex5wa60b+utvxwy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":748255},"type":"module","engines":{"node":">=18"},"gitHead":"5aa4d7f0e5b999fdee817019181f86965f1744f0","scripts":{"test":"tsx --test tests/stdio-mcp.test.ts","build":"rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/index.js","start":"tsx src/index.ts","test:live":"tsx --test tests/live-mcp-smoke.test.ts","prepublishOnly":"pnpm build && pnpm test"},"_npmUser":{"name":"quicknet123","email":"quicknet123@gmail.com"},"_npmVersion":"11.12.1","description":"Argus Browser MCP server (stdio) — drive antidetect browser profiles from Claude Desktop / Cursor via natural language. Bridges to the desktop Local API (AdsPower-compatible) over HTTP.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","zod":"^3.23.8","esbuild":"^0.25.0","express":"^5.2.1","typescript":"^5.7.0","@types/node":"^20.0.0","@types/express":"^5.0.0","playwright-core":"^1.49.0","@argus-browser/shared":"workspace:*","@modelcontextprotocol/sdk":"^1.7.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.0_1783840270520_0.9255924035928955","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@argus-browser/mcp-server","version":"0.3.0","type":"module","description":"Argus Browser MCP server (stdio) — drive antidetect browser profiles from Claude Desktop / Cursor via natural language. Bridges to the desktop Local API (AdsPower-compatible) over HTTP.","bin":{"argus-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"engines":{"node":">=18"},"scripts":{"build":"rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/index.js","start":"tsx src/index.ts","prepublishOnly":"pnpm build && pnpm test","test":"tsx --test tests/stdio-mcp.test.ts","test:live":"tsx --test tests/live-mcp-smoke.test.ts"},"devDependencies":{"@argus-browser/shared":"workspace:*","@modelcontextprotocol/sdk":"^1.7.0","@types/express":"^5.0.0","@types/node":"^20.0.0","esbuild":"^0.25.0","express":"^5.2.1","playwright-core":"^1.49.0","tsx":"^4.7.0","typescript":"^5.7.0","zod":"^3.23.8"},"gitHead":"64c569829c464fe2bb19ec7dd35159afb4ced412","_id":"@argus-browser/mcp-server@0.3.0","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-GB+6eZ3CLoOK7ku0qtNW78MoyfYT3cWUIx+CpSHOeQgxaauP7wdeisYYk7zv4p7aAs1TIJHqYQWsb59r4waeYw==","shasum":"c0e68c044bd39a18456be907fe35a8079ce0219f","tarball":"https://registry.npmjs.org/@argus-browser/mcp-server/-/mcp-server-0.3.0.tgz","fileCount":3,"unpackedSize":752680,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDm++XHbWDyuPwhmTTu4Jl0bRoAP1TW4Du+B7WYr1S6OAIgXWhTICWtzlzRSz52YoHdN86MTNJUTvwMzUNov2JLdJg="}]},"_npmUser":{"name":"quicknet123","email":"quicknet123@gmail.com"},"directories":{},"maintainers":[{"name":"quicknet123","email":"quicknet123@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.3.0_1783843939852_0.4903565650434225"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-12T06:26:18.571Z","modified":"2026-07-12T08:12:20.127Z","0.1.0":"2026-07-12T06:26:18.908Z","0.1.1":"2026-07-12T06:35:53.175Z","0.2.0":"2026-07-12T07:11:10.680Z","0.3.0":"2026-07-12T08:12:20.025Z"},"description":"Argus Browser MCP server (stdio) — drive antidetect browser profiles from Claude Desktop / Cursor via natural language. Bridges to the desktop Local API (AdsPower-compatible) over HTTP.","maintainers":[{"name":"quicknet123","email":"quicknet123@gmail.com"}],"readme":"# @argus-browser/mcp-server\n\nArgus Browser 的 **MCP 服务器（stdio 传输）**。让 Claude Desktop / Cursor 等 AI 客户端用自然语言直接操作 Argus 浏览器环境（创建/启动/关闭 profile、管理分组与代理）。\n\n## 架构\n\n它走 **stdio**（所有桌面 MCP 客户端的默认传输），再把每个工具调用桥接到正在运行的 Argus 桌面端 **Local API**（AdsPower 兼容 REST，默认 `127.0.0.1:50325`）：\n\n```\nClaude Desktop ──stdio──> argus-mcp ──HTTP REST──> Argus Local API :50325 ──> 浏览器引擎\n```\n\n> 与 AdsPower 官方 MCP 同构：MCP 进程本身不直接碰引擎，只翻译成对本地 REST 的调用。因此需要**先打开 Argus 桌面端**（Local API 在跑）。\n\n## 在 Claude Desktop 配置\n\n编辑 `claude_desktop_config.json`：\n\n- macOS/Linux：`~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows：`%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"argus-browser\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@argus-browser/mcp-server\"]\n    }\n  }\n}\n```\n\nCursor 同理（Settings → MCP → 添加同样的 command/args）。\n\n### 可选环境变量\n\n| 变量 | 默认 | 说明 |\n|---|---|---|\n| `ARGUS_API_PORT`（或 `PORT`） | `50325` | Local API 端口 |\n| `ARGUS_API_HOST` | `127.0.0.1` | Local API 主机 |\n| `ARGUS_API_KEY`（或 `API_KEY`） | 空 | 开启 API 验证时的 Bearer key |\n\n也支持 CLI 参数：`--port` / `--host` / `--api-key`。\n\n## 工具集\n\n| 工具 | 作用 | 桥接端点 |\n|---|---|---|\n| `list_profiles` | 分页列出环境 | POST `/api/v2/browser-profile/list` |\n| `get_profile` | 取单个环境 | POST `/list`（按 id 过滤） |\n| `create_profile` | 新建环境 | POST `/api/v2/browser-profile/create` |\n| `update_profile` | 改环境字段 | POST `/api/v2/browser-profile/update` |\n| `delete_profiles` | 删除（软删） | POST `/api/v2/browser-profile/delete` |\n| `move_profiles` | 移动到分组 | POST `/api/v1/user/regroup` |\n| `launch_browser` | 启动浏览器（返回 CDP debug_port） | POST `/api/v2/browser-profile/start` |\n| `stop_browser` | 关闭浏览器 | POST `/api/v2/browser-profile/stop` |\n| `stop_all_browsers` | 关闭全部 | POST `/api/v2/browser-profile/stop-all` |\n| `list_active_browsers` | 列出运行中的浏览器 | GET `/api/v1/browser/local-active` |\n| `get_browser_status` | 查询 Active/Inactive | GET `/api/v2/browser-profile/active` |\n| `list_groups` / `create_group` | 分组 | `/api/v1/group/*` |\n| `list_proxies` / `create_proxy` | 代理 | `/api/v2/proxy-list/*` |\n\n## 开发\n\n```bash\npnpm --filter @argus-browser/mcp-server start   # tsx 直跑（开发）\npnpm --filter @argus-browser/mcp-server build   # tsc → dist/\npnpm --filter @argus-browser/mcp-server test    # 端到端 stdio 测试（官方 MCP Client 真连）\n```\n\n测试用官方 `@modelcontextprotocol/sdk` Client 经真实 stdio 子进程连本服务，后端用对齐后的 `createRoutes()`，无需真桌面 app / 真浏览器。\n","readmeFilename":"README.md"}