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

airtop-mcp

Airtop MCP服务器是一个提供浏览器自动化服务的工具集,支持创建会话、窗口管理、页面查询等功能,可通过Claude应用集成使用。

article

README

🚀 Airtop MCP 服务器

Airtop MCP 服务器是一个模型上下文协议(MCP)服务器,提供了与 Airtop 浏览器自动化服务交互的工具,能够帮助开发者更便捷地实现相关功能。

🚀 快速开始

🛠️ 开发

以下是在开发环境中启动服务器的步骤:

  1. 克隆仓库。
  2. 安装依赖:
    npm install
    
  3. 设置你的 Airtop API 密钥:
    export AIRTOP_API_KEY=your_api_key_here
    
  4. 启动开发服务器:
    npm run dev -- --server
    

💻 在 Claude(Native MacOS)中使用

进入 Claude 应用,打开 设置 -> 开发者 -> 编辑配置,添加以下内容(将 your_api_key_here 替换为你的 Airtop API 密钥):

{
  "mcpServers": {
    "airtop": {
      "command": "npx",
      "args": ["-y", "airtop-mcp@latest"],
      "env": {
        "AIRTOP_API_KEY": "your_api_key_here"
      }
    }
  }
}

✨ 主要特性

服务器提供了以下可用工具:

  • createSession:创建新的 Airtop 浏览器会话。
  • createWindow:在会话中创建新浏览器窗口。
  • pageQuery:使用 AI 查询当前页面内容。
  • terminateSession:终止 Airtop 浏览器会话。
  • paginatedExtraction:从分页列表中提取数据。

📦 安装指南

服务器默认运行在 3456 端口。你可以通过设置 PORT 环境变量来更改端口。

📄 许可证

本项目采用 ISC 许可证。

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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