AdsPower CLI & MCP

Hinzufügen des adspower-browser-Skills

Verwenden Sie den adspower-browser-Skill, damit die KI AdsPower über die CLI ohne den MCP-Server steuern kann. Fügen Sie ihn wie folgt in Ihrem Editor hinzu:

AdsPower LocalAPI MCP-Server

Ein Model Context Protocol-Server für die AdsPower-Browser-LocalAPI. Dieser Server ermöglicht es LLMs, mit AdsPower-Browserprofilen über die v2-API zu interagieren, einschließlich des Erstellens, Aktualisierens und Löschens von Profilen, der Verwaltung von Gruppen und der Automatisierung von Browser-Vorgängen.

Verwendung mit Claude Desktop

Sprechen Sie mit LLMs, um einen Browser zu erstellen: Create an Android UA browser using Chrome 134

Sprechen Sie mit LLMs, um Browser zu erstellen: Help me with random UA, random fingerprint, random cookie generation, create 3 browsers, use 134 cores, and open them

Wie wird es verwendet?

Voraussetzungen

• AdsPower

• Node-Version 18 oder höher

Versionskompatibilität

Einige APIs werden schrittweise durch die AdsPower-Client-Version eingeführt. Wenn der Client nicht auf eine Version aktualisiert wurde, die eine bestimmte API enthält, geben Anfragen möglicherweise Not found zurück.

Wenn dies passiert:

• Aktualisieren Sie zuerst den AdsPower-Client auf die neueste Patch-Version.

• Wiederholen Sie dann denselben Befehl/API-Aufruf.

Installation

Um es mit Claude Desktop zu verwenden, fügen Sie die Serverkonfiguration hinzu:

Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Unter 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"]
    }
  }
}

Konfigurationsparameter

Der MCP-Server unterstützt die Konfiguration über Befehlszeilenargumente oder Umgebungsvariablen.

Port-Konfiguration

Der Port-Parameter gibt den AdsPower Local API-Port an. Der Standardwert ist 50325.

Prioritätsreihenfolge:

1. Befehlszeilenargument --port (höchste Priorität)

2. Umgebungsvariable PORT (mittlere Priorität)

3. Standardwert 50325 (niedrigste Priorität)

Beispiele:

Verwendung des Befehlszeilenarguments:

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

Verwendung der Umgebungsvariable:

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

API-Schlüssel-Konfiguration

Der API-Schlüssel wird zur Authentifizierung bei der AdsPower-API verwendet. Er wird als Authorization: Bearer <api-key>-Header in Anfragen gesendet.

Prioritätsreihenfolge:

1. Befehlszeilenargument --api-key (höchste Priorität)

2. Umgebungsvariable API_KEY (mittlere Priorität)

3. Kein Standardwert (falls nicht angegeben, enthalten Anfragen den API-Schlüssel-Header nicht)

Beispiele:

Verwendung des Befehlszeilenarguments:

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

Verwendung der Umgebungsvariable:

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

Kombinierte Konfiguration

Sie können beide Parameter zusammen verwenden. Befehlszeilenargumente überschreiben Umgebungsvariablen:

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

In diesem Beispiel verwendet der Server port: 50326 und apiKey: new-key (Befehlszeilenargumente überschreiben Umgebungsvariablen).

oder verwenden Sie es in Cursor

Related MCP server: Puppeteer MCP Server

Entwicklung

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

# install (monorepo)
pnpm install

# build all packages
pnpm run build

Für die lokale MCP-Entwicklung verweisen Sie Claude Desktop auf das MCP-Paket:

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