Apify Model Context Protocol (MCP) Server

Apify Model Context Protocol (MCP) Server

site icon
2025.04.04 0
TypeScript数据提取网页搜索任务自动化浏览器自动化搜索工具开发效率
Apify Model Context Protocol (MCP) Server 是一个用于与Apify Actors交互的服务器,支持通过Server-Sent Events (SSE)或标准输入/输出(stdio)进行通信。它允许AI助手使用Apify Actors作为工具来执行特定任务,如数据提取、网页搜索等。
View on GitHub

Overview

基本能力

产品定位

Apify MCP Server 是一个中间件,用于连接AI助手和Apify Actors,使AI能够利用Apify平台上的各种工具进行数据提取和任务自动化。

核心功能

  • 支持通过SSE或stdio与Apify Actors交互
  • 预配置多个常用Apify Actors作为工具
  • 动态加载Actor输入参数并自动传递给LLM
  • 提供简单的客户端示例进行交互测试

适用场景

  • 数据提取:如从Facebook、Instagram等平台提取数据
  • 网页搜索:如使用Google搜索并返回结果
  • 位置服务:如从Google Maps提取联系信息
  • 内容分析:如分析社交媒体资料

工具列表

  1. apify/instagram-scraper:用于抓取Instagram帖子、个人资料、地点、照片和评论
  2. apify/rag-web-browser:用于搜索网页,抓取前N个URL并返回其内容
  3. lukaskrivka/google-maps-with-contact-details:用于从Google Maps提取联系信息

常见问题解答

  • 内存限制:每个Actor限制为4GB内存
  • 输入参数限制:输入模式中的属性被修剪,描述截断为200个字符
  • 枚举字段限制:最多50个选项

使用教程

使用依赖

  • Node.js (v18或更高版本)
  • Apify API Token

安装教程

  1. 克隆仓库:
git clone [email protected]:apify/actor-mcp-server.git
  1. 进入项目目录并安装依赖:
cd actor-mcp-server
npm install
  1. 构建项目:
npm run build

调试方式

  1. 使用MCP Inspector进行调试:
npx @modelcontextprotocol/inspector node @apify/actors-mcp-server --env APIFY_TOKEN=your-apify-token
  1. 访问Inspector提供的URL进行调试

交互示例

  1. 启动SSE连接:
curl https://actors-mcp-server.apify.actor/sse?token=<APIFY_TOKEN>
  1. 发送消息:
curl -X POST "https://actors-mcp-server.apify.actor/message?token=<APIFY_TOKEN>&session_id=a1b" -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "arguments": { "searchStringsArray": ["restaurants in San Francisco"], "maxCrawledPlacesPerSearch": 3 },
    "name": "lukaskrivka/google-maps-with-contact-details"
  }
}'

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。