返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端