Apify Actors MCP服务器详细介绍

项目概述

Apify Actors MCP服务器是一个基于模型上下文协议（Model Context Protocol, MCP）的服务器实现，专门为Apify平台上的所有Actor提供统一的接口访问。该项目使AI应用和AI代理能够通过标准化的协议与Apify的数据提取工具进行交互。

项目地址: https://github.com/apify/actors-mcp-server
主要用途: 将Apify Store中的200多个数据提取工具作为AI工具集成到各种AI应用中
支持平台: Claude Desktop、Visual Studio Code、LibreChat等多种MCP客户端

核心功能特性

🔧 双重部署模式

• MCP服务器Actor: 作为HTTP服务器运行在Apify平台上，通过服务器发送事件(SSE)提供访问
• 本地Stdio服务器: 在本地机器上运行，通过标准输入/输出(stdio)与客户端通信

🛠️ 丰富的工具集成

项目默认预配置了以下核心Actor工具：

• Instagram爬虫 (apify/instagram-scraper): 提取Instagram帖子、个人资料、地点、照片和评论
• RAG网络浏览器 (apify/rag-web-browser): 网络搜索、爬取页面内容并返回结构化数据
• Google Maps联系方式提取器 (lukaskrivka/google-maps-with-contact-details): 提取Google Maps上的商家联系信息

🔍 智能工具发现

• get-actor-details: 检索特定Actor的文档、输入模式和详细信息
• discover-actors: 使用关键词搜索相关Actor并返回详细信息
• 动态工具管理: 支持运行时添加和移除Actor工具（需要客户端支持）

🎯 多客户端支持

支持以下MCP客户端：

• Claude Desktop: 通过Stdio传输协议
• Visual Studio Code: 支持Stdio和SSE传输
• LibreChat: 支持Stdio和SSE传输
• Apify测试客户端: 完整的SSE支持和授权头
• 其他标准MCP客户端

技术架构

协议支持

• MCP (Model Context Protocol): 开放协议，实现AI应用与外部工具的安全可控交互
• 传输方式:
  • Server-Sent Events (SSE) - 用于远程HTTP服务器
  • Standard Input/Output (Stdio) - 用于本地进程通信

输入处理优化

• 描述截断: 限制在500字符以内提高兼容性
• 枚举字段优化: 合并长度限制在200字符内
• 必填字段标记: 明确标识必填参数
• 嵌套属性构建: 处理代理配置等复杂结构
• 类型推断: 自动推断数组项类型

使用场景示例

数据研究分析

"搜索网络并总结AI代理的最新趋势"
"查找并分析The Rock的Instagram个人资料"

商业信息收集

"找出旧金山排名前10的最佳意大利餐厅"
"提取特定区域的Google Maps商家联系信息"

内容创作支持

"提供使用模型上下文协议的分步指南和源URL"
"分析Facebook页面的最新帖子趋势"

安装配置

Claude Desktop配置

{
  "mcpServers": {
    "actors-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Visual Studio Code配置

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apify_token",
        "description": "Apify API Token",
        "password": true
      }
    ],
    "servers": {
      "actors-mcp-server": {
        "command": "npx",
        "args": ["-y", "@apify/actors-mcp-server"],
        "env": {
          "APIFY_TOKEN": "${input:apify_token}"
        }
      }
    }
  }
}

自定义Actor配置

{
  "command": "npx",
  "args": [
    "-y", "@apify/actors-mcp-server",
    "--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
  ],
  "env": {
    "APIFY_TOKEN": "your-apify-token"
  }
}

系统需求

基础环境

• Node.js: v18或更高版本
• 操作系统: macOS、Windows或Linux
• Apify API Token: 用于访问Apify平台服务

客户端要求

• Claude Desktop最新版本
• Visual Studio Code（支持MCP扩展）
• 或其他兼容的MCP客户端

性能限制

资源配置

• 内存限制: 每个Actor限制4GB内存
• 免费用户: 总计8GB限制，需为MCP服务器预留128MB
• 并发处理: 支持多个Actor同时运行

架构优化

• 模式处理: JSON Schema标准兼容
• 描述优化: 自动截断和格式化
• 错误处理: 完善的异常处理机制

开发调试

MCP检查器工具

export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-server

示例客户端

项目提供了完整的示例代码：

• Stdio客户端: examples/clientStdio.ts
• SSE客户端: examples/clientSse.ts

项目总结

Apify Actors MCP服务器代表了AI应用工具集成的重要进步，它通过标准化的MCP协议将强大的数据提取能力带给了各种AI应用。该项目的主要价值包括：

核心优势

1. 统一接口: 通过单一协议访问200多个专业数据提取工具
2. 灵活部署: 支持云端和本地两种部署模式
3. 广泛兼容: 与主流AI开发工具和平台集成
4. 易于扩展: 支持动态添加和定制Actor工具

应用价值

• 提升AI能力: 为AI应用提供实时数据获取能力
• 简化集成: 标准化接口降低开发复杂度
• 扩展可能: 开放的架构支持无限扩展
• 企业就绪: 成熟的平台和完善的文档支持

适用场景

• AI代理开发
• 数据分析和研究
• 内容创作和管理
• 商业智能和市场研究
• 自动化数据收集

这个项目为AI应用的数据获取需求提供了一个强大、灵活且易于使用的解决方案，是现代AI工具栈中的重要组成部分。