关键词

浏览器管理AdsPower本地API自动化账号管理

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为 AdsPower 浏览器管理工具提供标准化的接口。它允许大型语言模型 (LLM) 客户端通过 MCP 协议与 AdsPower Local API 进行交互，从而实现对浏览器和用户组的管理和查询。

主要功能点

  • 浏览器管理工具接口: 提供创建、打开、关闭、更新、删除和查询浏览器实例的功能。
  • 用户组管理接口: 支持创建、更新和查询用户组。
  • 应用列表查询: 允许获取应用列表信息。
  • 标准 MCP 协议: 基于 JSON-RPC over Stdio 实现，易于集成到支持 MCP 协议的 LLM 应用中。
  • 工具注册: 注册了一系列工具 (Tools)，方便 LLM 客户端调用 AdsPower Local API 的各项功能。
  • 能力声明: 声明了服务器提供的资源 (Resources) 和工具 (Tools) 能力。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。
  2. 克隆仓库: 使用 Git 克隆 'local-api-mcp-typescript' 仓库到本地。 
    git clone https://github.com/AdsPower/local-api-mcp-typescript.git
cd local-api-mcp-typescript
  3. 安装依赖: 在仓库根目录下运行 npm install 命令安装项目依赖。 
    npm install
  4. 构建项目: 运行 npm run build 命令编译 TypeScript 代码。 
    npm run build

服务器配置

MCP 客户端需要以下配置信息来连接到此 MCP 服务器。请将以下 JSON 配置添加到 MCP 客户端的服务器配置中：

{
  "serverName": "adspower-local-api",
  "command": "node",
  "args": [
    "dist/index.js"
  ],
  "transport": "stdio"
}
  • 'serverName': 服务器名称，设置为 "adspower-local-api"。
  • 'command': 启动服务器的命令，这里使用 Node.js 运行环境，所以设置为 "node"。
  • 'args': 启动命令的参数，指定了编译后的入口文件 "dist/index.js"。
  • 'transport': 传输协议，本项目使用 Stdio，设置为 "stdio"。

注意: 确保 MCP 客户端能够访问到 'node' 命令以及 'dist/index.js' 文件路径（相对于客户端的执行环境）。

基本使用方法

  1. 启动 MCP 服务器: 在仓库根目录下运行以下命令启动 MCP 服务器。 
    npm start
    服务器将在 stdio 上运行，并输出 "AdsPower Local Api MCP Server running on stdio" 信息。
  2. 配置 MCP 客户端: 在 LLM 客户端中配置上述服务器配置信息。
  3. 调用工具: 通过 MCP 客户端，你可以调用服务器注册的工具 (Tools) 来管理 AdsPower 浏览器。例如，可以使用 'open-browser' 工具打开浏览器，使用 'get-browser-list' 工具获取浏览器列表等。 具体的工具和参数可以参考代码中的 'src/utils/toolRegister.ts' 和 'src/types/schemas.ts' 文件。

信息

分类

桌面与硬件

访问项目