Back to MCP directory
publicPublicdnsLocal runtime

local-api-mcp-python

AdsPower浏览器LocalAPI的MCP服务器,支持通过LLM指令操作浏览器创建及配置

article

README

🚀 AdsPower 本地API MCP 服务器 Python

这是一个基于 Model Context Protocol (MCP) 的服务器,允许大型语言模型(LLM)与 AdsPower 浏览器进行交互。该服务器赋予了 LLM 强大的浏览器控制能力,支持启动浏览器、创建新的浏览器实例以及更新指纹配置等操作。

🚀 快速开始

Claude Desktop 版本使用说明

若要通过 Claude 桌面版创建一个使用 Chrome 134 内核的 Android 用户代理(UA)浏览器,只需向 LLM 发出如下指令:

Create an Android UA browser using Chrome 134

Claude 桌面版

Cursor 版本使用说明

Cursor

📦 安装指南

系统需求

  • AdsPower
  • 已安装 Python 3.10 或更高版本。

环境配置与 uv 安装

首先,按照以下步骤安装 uv 并设置您的 Python 开发环境:

MacOS/Linux 操作系统

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows 操作系统

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

开发步骤

# 克隆代码仓库
git clone https://github.com/AdsPower/local-api-mcp-python.git

# 切换到项目目录
cd local-api-mcp-python

# 创建虚拟环境并激活
uv venv
source .venv/bin/activate

# 安装依赖项
uv pip install .

配置 Claude 桌面版使用本服务器

将以下配置添加到您的 claude_desktop_config.json 文件中:

  • 对于 MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • 对于 Windows:%APPDATA%/Claude/claude_desktop_config.json
# 修改 claude_desktop_config.json 文件内容如下:
{
    "mcpServers": {
        "adspower-local-api": {
            "command": "uv",
            "args": [
                "--directory",
                "<Replace Your Project Path>/local-api-mcp-python",
                "run",
                "main.py"
            ]
        }
    }
}
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client