AdsPower LocalAPI MCP 服务器

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

与Claude Desktop一起使用

通过与LLMs对话来创建浏览器：使用Chrome 134创建一个Android UA浏览器

通过与LLMs对话来创建浏览器：帮我随机生成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 clone 
git clone https://github.com/AdsPower/local-api-mcp-typescript.git

# install package
cd local-api-mcp-typescript && npx pnpm i

# build
npm run build

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "adspower-local-api": {
        "command": "node",
        "args": [
            "<Replace Your Project Path>/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 配置