Local API MCP Typescript

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

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                     # 启动 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

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

• AdsPower

• Node version 18 or greater

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": ["/adspower-browser/packages/local-api-mcp/build/index.js"]
  }
}

Use AdsPower Cli in Docker

copy the

cd packages/adspower-browser

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

docker-compose exec adspower-cli /bin/bash