AdsPower LocalAPI MCP

How to Install and Use AdsPower LocalAPI MCP

If you want to control AdsPower browsers using a simple local API server, AdsPower LocalAPI MCP is a great tool for that. It lets you create, open, close, and manage browsers easily with commands you can run locally. Here’s how to install and use it step-by-step with clear examples.

Requirements for Using AdsPower LocalAPI MCP

Before installing, make sure your system meets two important needs. First, you must have AdsPower installed and running because the API connects to the AdsPower browser software. Second, you need Node version 18 or greater on your computer, as the server depends on Node.js to run. Make sure these are ready before the next steps.

Installing AdsPower LocalAPI MCP

Now, let's get the AdsPower LocalAPI MCP server on your machine. The easiest way for most users is to run it with Claude Desktop or command line.

For MacOS and Linux

If you use Mac or Linux, add this configuration to your Claude desktop config file, typically at ~/Library/Application Support/Claude/claude_desktop_config.json:

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

This tells Claude to automatically run the AdsPower LocalAPI MCP server using npx.

For Windows

Windows users should add a similar config at %APPDATA%/Claude/claude_desktop_config.json:

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

This runs the server via Windows command prompt.

Development and Manual Setup

If you want to develop or customize, here’s how to set it up manually:

1. Clone the repository:

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

2. Go into the project folder and install dependencies:

   cd local-api-mcp-typescript && npx pnpm i
   

3. Build the project:

   npm run build
   

4. Update your Claude desktop config file to run the built server:

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

Replace <Replace Your Project Path> with your actual folder path.

Using AdsPower LocalAPI MCP with Examples

You can interact with AdsPower browsers by sending commands to the server. Here are a couple of practical examples showing how to create and open browsers:

• To create an Android user-agent browser using Chrome version 134, simply tell the server:

  Create an Android UA browser using Chrome 134
  

• Or generate browsers with random user agents and fingerprints, like this:

  Help me with random UA, random fingerprint, random cookie generation, create 3 browsers, use 134 cores, and open them
  

These commands let you manage browsers easily without complex coding.

Summary

AdsPower LocalAPI MCP is simple to install and use if you follow these steps. Just make sure you have AdsPower and Node.js ready, then configure Claude or run the server manually. With this setup, you can quickly create browsers, update fingerprints, and manage groups all through neat commands. It’s fast, practical, and designed to make browser automation easier for you.