Skip to main content
Glama
AdsPower

AdsPower LocalAPI MCP Server

Official
by AdsPower

AdsPower CLI 与 MCP

添加 adspower-browser 技能

使用 adspower-browser 技能,以便 AI 无需 MCP 服务器即可通过 CLI 操作 AdsPower。请在编辑器中按如下方式添加:

环境

添加方式

Cursor

npx skills add AdsPower/adspower-browser

Claude Code

npx skills add AdsPower/adspower-browser

GPT / Codex

如果您的设置支持 add-skillnpx skills add AdsPower/adspower-browser。否则,请将 skills/adspower-browser/ 中的技能复制到您代理的技能目录中(例如 ~/.codex/skills/adspower-browser/)。

AdsPower LocalAPI MCP 服务器

一个用于 AdsPower 浏览器 LocalAPI 的模型上下文协议(MCP)服务器。该服务器使 LLM 能够使用 v2 API 与 AdsPower 浏览器配置文件进行交互,包括创建、更新、删除配置文件、管理分组以及自动化浏览器操作。

在 Claude Desktop 中使用

通过与 LLM 对话创建浏览器:Create an Android UA browser using Chrome 134

Claude desktop

通过与 LLM 对话创建浏览器:Help me with random UA, random fingerprint, random cookie generation, create 3 browsers, use 134 cores, and open them

Claude desktop

如何使用?

要求

版本兼容性

某些 API 是由 AdsPower 客户端版本逐步引入的。 如果客户端尚未升级到包含特定 API 的版本,请求可能会返回 Not found

发生这种情况时:

  • 首先将 AdsPower 客户端升级到最新的补丁版本。

  • 然后重试相同的命令/API。

安装

要在 Claude Desktop 中使用,请添加服务器配置:

macOS 上:~/Library/Application Support/Claude/claude_desktop_config.json Windows 上:%APPDATA%/Claude/claude_desktop_config.json

MacOS / Linux
{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript"]
    }
  }
}
Windows
{
  "mcpServers": {
    "adspower-local-api": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "local-api-mcp-typescript"]
    }
  }
}

配置参数

MCP 服务器支持通过命令行参数或环境变量进行配置。

端口配置

端口参数指定 AdsPower Local API 端口。默认值为 50325

优先级顺序:

  1. 命令行参数 --port(最高优先级)

  2. 环境变量 PORT(中等优先级)

  3. 默认值 50325(最低优先级)

示例:

使用命令行参数:

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

使用环境变量:

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

API Key 配置

API Key 用于 AdsPower API 的身份验证。它将在请求中作为 Authorization: Bearer <api-key> 标头发送。

优先级顺序:

  1. 命令行参数 --api-key(最高优先级)

  2. 环境变量 API_KEY(中等优先级)

  3. 无默认值(如果未提供,请求将不包含 API Key 标头)

示例:

使用命令行参数:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript", "--api-key", "your-api-key-here"]
    }
  }
}

使用环境变量:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

组合配置

您可以同时使用这两个参数。命令行参数将覆盖环境变量:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript", "--port", "50326", "--api-key", "new-key"],
      "env": {
        "PORT": "50325",
        "API_KEY": "old-key"
      }
    }
  }
}

在此示例中,服务器将使用 port: 50326apiKey: new-key(命令行参数覆盖了环境变量)。

Claude desktop MCP

或在 Cursor 中使用 Cursor

Related MCP server: Puppeteer MCP Server

开发

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

# install (monorepo)
pnpm install

# build all packages
pnpm run build

对于本地 MCP 开发,请将 Claude Desktop 指向 MCP 包:

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

Maintenance

Maintainers
15dResponse time
Release cycle
Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
    32
    19,640
    5,633
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
    18
    Apache 2.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that enables LLMs to automate web browsers using Puppeteer, allowing navigation, screenshots, form filling, and JavaScript execution in a real browser environment.
    2
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol server that provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
    7
    23,406
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • A Model Context Protocol server for Wix AI tools

  • MCP server for AI dialogue using various LLM models via AceDataCloud

View all MCP Connectors

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