Skip to main content
Glama
AdsPower

AdsPower LocalAPI MCP Server

Official
by AdsPower

AdsPower CLI 및 MCP

adspower-browser 스킬 추가하기

AI가 MCP 서버 없이 CLI를 통해 AdsPower를 조작할 수 있도록 adspower-browser 스킬을 사용하세요. 다음과 같이 에디터에 추가하십시오:

환경

추가 방법

Cursor

npx skills add AdsPower/adspower-browser

Claude Code

npx skills add AdsPower/adspower-browser

GPT / Codex

add-skill을 지원하는 경우: npx skills add AdsPower/adspower-browser. 그렇지 않은 경우 skills/adspower-browser/에서 에이전트의 스킬 디렉토리(예: ~/.codex/skills/adspower-browser/)로 스킬을 복사하십시오.

AdsPower LocalAPI MCP 서버

AdsPower 브라우저 LocalAPI를 위한 Model Context Protocol 서버입니다. 이 서버를 통해 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 키 구성

API 키는 AdsPower API 인증에 사용됩니다. 요청 시 Authorization: Bearer <api-key> 헤더로 전송됩니다.

우선순위:

  1. 명령줄 인수 --api-key (최고 우선순위)

  2. 환경 변수 API_KEY (중간 우선순위)

  3. 기본값 없음 (제공되지 않으면 요청에 API 키 헤더가 포함되지 않음)

예시:

명령줄 인수 사용:

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