AdsPower LocalAPI MCP 服务器

这是一个与AdsPower浏览器LocalAPI交互的模型上下文协议服务器。该服务器使大型语言模型能够与启动浏览器、创建浏览器、更新浏览器指纹配置等功能进行交互...

与Claude Desktop的使用

通过大型语言模型创建浏览器：使用Chrome 134创建一个Android UA浏览器

通过大型语言模型创建浏览器：帮助我生成随机UA、随机指纹、随机cookie，创建3个浏览器，使用134核心，并打开它们

如何使用？

要求

• AdsPower

• Node版本18或更高

安装

要在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"]
    }
  }
}

或者在Cursor中使用

开发

# git克隆
git clone https://github.com/AdsPower/local-api-mcp-typescript.git

# 安装包
cd local-api-mcp-typescript && npx pnpm i

# 构建
npm run build

# 将服务器添加到您的claude_desktop_config.json
"mcpServers": {
  "adspower-local-api": {
        "command": "node",
        "args": [
            "<替换您的项目路径>/local-api-mcp-typescript/build/index.js"
        ]
    }
}

组件

工具

• open_browser

  • 打开浏览器
  • 输入参数：
    • serialNumber (字符串，可选)：要打开的浏览器序列号
    • userId (字符串，可选)：要打开的浏览器ID

• close_browser

  • 关闭浏览器
  • 输入参数：
    • userId (字符串)：要停止的浏览器ID

• create_browser

  • 创建浏览器
  • 输入参数：
    • groupId (字符串)：浏览器的组ID
    • domainName (字符串，可选)：域名
    • openUrls (字符串数组，可选)：要打开的URL
    • cookie (字符串，可选)：浏览器cookie
    • username (字符串，可选)：用户名
    • password (字符串，可选)：密码
    • system (字符串，可选)：系统类型
    • name (字符串，可选)：浏览器名称
    • country (字符串，可选)：国家
    • sysAppCateId (字符串，可选)：系统应用类别ID
    • storageStrategy (数字，可选)：存储策略
    • userProxyConfig (对象)：代理配置
    • fingerprintConfig (对象，可选)：浏览器指纹配置

• update_browser

  • 更新浏览器
  • 输入参数：与create_browser相同，加上：
    • userId (字符串)：要更新的浏览器用户ID

• delete_browser

  • 删除浏览器
  • 输入参数：
    • userIds (字符串数组)：要删除的浏览器用户ID

• get_browser_list

  • 获取浏览器列表
  • 输入参数：
    • groupId (字符串，可选)：浏览器的组ID
    • size (数字，可选)：页面大小
    • id (字符串，可选)：浏览器ID
  • serialNumber (字符串，可选)：浏览器序列号
  • sort (枚举，可选)：排序字段 ('serial_number' | 'last_open_time' | 'created_time')
  • order (枚举，可选)：排序顺序 ('asc' | 'desc')

• get-opened_browser

  • 获取已打开的浏览器列表
  • 不需要输入参数

• move_browser

  • 将浏览器移动到一个组
  • 输入参数：
    • groupId (字符串)：目标组ID
    • userIds (字符串数组)：要移动的浏览器ID

• create_group

  • 创建浏览器组
  • 输入参数：
    • groupName (字符串)：要创建的组名称
    • remark (字符串，可选)：组备注

• update_group

  • 更新浏览器组
  • 输入参数：
    • groupId (字符串)：要更新的组ID
    • groupName (字符串)：新的组名称
    • remark (字符串或null，可选)：新的组备注，设置为null以清除

• get_group_list

  • 获取组列表
  • 输入参数：
    • name (字符串，可选)：组名称
    • size (数字，可选)：页面大小

• get-application_list

  • 获取应用程序列表
  • 输入参数：
    • size (数字，可选)：页面大小

高级配置类型

UserProxyConfig

• proxy_soft (枚举)：代理软件类型 ('brightdata', 'brightauto', 'oxylabsauto'等)
• proxy_type (枚举，可选)：代理类型 ('http', 'https', 'socks5', 'no_proxy')
• proxy_host (字符串，可选)：代理主机
• proxy_port (字符串，可选)：代理端口
• proxy_user (字符串，可选)：代理用户名
• proxy_password (字符串，可选)：代理密码
• proxy_url (字符串，可选)：代理URL
• global_config (枚举，可选)：全局配置 ('0' | '1')

FingerprintConfig

• automatic_timezone (枚举，可选)：自动时区 ('0' | '1')
• timezone (字符串，可选)：时区
• language (字符串数组，可选)：语言
• flash (字符串，可选)：Flash版本
• fonts (字符串数组，可选)：字体列表
• webrtc (枚举，可选)：WebRTC设置 ('disabled' | 'forward' | 'proxy' | 'local')
• browser_kernel_config (对象，可选)：
  • version (字符串，可选)：浏览器版本
  • type (枚举，可选)：浏览器类型 ('chrome' | 'firefox')
• random_ua (对象，可选)：
  • ua_version (字符串数组，可选)：用户代理版本
  • ua_system_version (枚举数组，可选)：系统版本
• tls_switch (枚举，可选)：TLS开关 ('0' | '1')
• tls (字符串，可选)：TLS配置