Development · MODEL CONTEXT PROTOCOL

AdsPower local api mcp typescript

Name: AdsPower local api mcp typescript
Author: AdsPower

MCP server for using the AdsPower LocalAPI

Open source All MCP Servers

WHAT IT CONNECTS

What AdsPower local api mcp typescript gives an AI Agent

The source catalog does not include a structured feature list. Review the repository documentation before use.

SECURITY

An MCP listing is not a security review

An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.

README

Repository documentation

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 <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

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:

Command-line argument --port (highest priority)
Environment variable PORT (medium priority)
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

View README on GitHub

COMMUNITY

Save, rate, and discuss

Loading community data…