VOOZH about

URL: https://glama.ai/mcp/servers/AdsPower/adspower-browser

⇱ AdsPower LocalAPI MCP Server by AdsPower | Glama


AdsPower Skill & MCP & CLI

adspower-browser Skill

Claude Code/Codex/Cursor/OpenCode/Gemini GL

npx skills add https://github.com/adspower/adspower-browser --skill adspower-browser

OpenClaw(小龙虾)

npx clawhub@latest install adspower-browser --force

Hermes agent(爱马仕)

hermes skills install https://github.com/AdsPower/adspower-browser/blob/main/skills/adspower-browser --force

Related MCP server: Puppeteer MCP Server

AdsPower CLI

The AdsPower CLI is completely isolated from the AdsPower client, runs independently, and does not share local caches/kernels, etc. However, the CLI also supports headless mode for operating the AdsPower client.

npm install -g adspower-browser # 安装

ads start -k <KEY> # 启动 adspower
ads stop # 停止 adspower
ads restart # 重启 adspower
ads status # 查询 adspower 运行状态
ads get-browser-list # 获取配置文件列表
... #查看 https://github.com/AdsPower/adspower-browser/blob/main/packages/adspower-browser/README.MD

AdsPower client headless mode:

AdsPower Global:
Windows: "AdsPower Global.exe" --headless=true --api-key=your_api_key --api-port=50325
MacOS:"/Applications/AdsPower Global.app/Contents/MacOS/AdsPower Global" --args --headless=true --api-key=your_api_key --api-port=50325
Linux:adspower_global --headless=true --api-key=your_api_key --api-port=50325

AdsPower MCP

Claude Code:

claude mcp add adspower-local-api -e PORT="50325" -e API_KEY="your_api_key" -- npx -y local-api-mcp-typescript

Codex:

codex mcp add --env PORT="50325" --env API_KEY="your_api_key" adspower-local-api -- npx -y local-api-mcp-typescript

OpenClaw:

openclaw mcp set adspower-local-api '{"command":"npx","args":["-y","local-api-mcp-typescript"],"env":{"PORT":"50325","API_KEY":"your_api_key"}}'

Cursor: Go to Cursor Settings -> MCP -> Add New MCP Server, and then paste the following content:

{
 "mcpServers": {
 "adspower-local-api": {
 "command": "npx",
 "args": ["-y", "local-api-mcp-typescript"],
 "env": {
 "PORT": "50325",
 "API_KEY": "your_api_key"
 }
 }
 }
}

OpenCode: update ~/.config/opencode/opencode.json

{
 "$schema": "https://opencode.ai/config.json",
 "mcp": {
 "adspower-local-api": {
 "command": "npx",
 "args": ["-y", "local-api-mcp-typescript"],
 "env": {
 "PORT": "50325",
 "API_KEY": "your_api_key"
 }
 }
 }
}

How to use?

Requirements

Version Compatibility

Some APIs are introduced incrementally by AdsPower client version.
If the client has not been upgraded to a version that includes a specific API, requests may return Not found.

When this happens:

  • Upgrade AdsPower client to the latest patch version first.

  • Then retry the same command/API.

Port Configuration

The port parameter specifies the AdsPower Local API port. Default is 50325.

Priority order:

  1. Command-line argument --port (highest priority)

  2. Environment variable PORT (medium priority)

  3. Default value 50325 (lowest priority)

Examples:

Using command-line argument:

{
 "mcpServers": {
 "adspower-local-api": {
 "command": "npx",
 "args": ["-y", "local-api-mcp-typescript", "--port", "50325"]
 }
 }
}

Using environment variable:

{
 "mcpServers": {
 "adspower-local-api": {
 "command": "npx",
 "args": ["-y", "local-api-mcp-typescript"],
 "env": {
 "PORT": "50325"
 }
 }
 }
}

Development

# clone
git clone https://github.com/AdsPower/adspower-browser.git
cd adspower-browser

# install (monorepo)
pnpm install

# build all packages
pnpm run build

For local MCP development, point Claude Desktop to the MCP package:

"mcpServers": {
 "adspower-local-api": {
 "command": "node",
 "args": ["<Replace Your Project Path>/adspower-browser/packages/local-api-mcp/build/index.js"]
 }
}

Use AdsPower Cli in Docker

copy the /packages/adspower-browser/docker-compose.yml

cd packages/adspower-browser

docker-compose -f ./docker-compose.yml up -d

docker-compose exec adspower-cli /bin/bash

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AdsPower/adspower-browser'

If you have feedback or need assistance with the MCP directory API, please join our Discord server