使用说明

项目简介

Apify Actors MCP Server 是一个 Model Context Protocol (MCP) 服务器的实现，旨在将 Apify Actors 集成为 AI 应用的工具。通过遵循 MCP 协议，该服务器允许大型语言模型（LLM）客户端安全、可控地调用 Apify Actors 执行各种任务，例如网页抓取、数据提取等。该项目支持多种传输协议，包括 Server-Sent Events (SSE) 和 Stdio，以适应不同的部署环境和客户端需求。

主要功能点

Apify Actors 即服务: 将 Apify 平台丰富的 Actor 库转化为可供 LLM 客户端调用的工具，扩展 LLM 的能力边界。
工具发现与管理: 提供工具发现机制，允许 LLM 客户端查询和了解可用的 Apify Actors 工具。同时支持动态添加和移除工具，提升灵活性。
多种传输协议支持: 支持通过 Server-Sent Events (SSE) 进行云端部署，以及通过 Stdio 在本地运行，满足不同场景的需求。
预配置常用工具: 默认配置了常用的 Apify Actors 作为工具，开箱即用，并支持自定义配置 Actor 列表。
会话管理: 服务器端负责会话管理，确保与客户端的稳定通信。

安装步骤

环境准备: 确保已安装 Node.js (v18 或更高版本) 和 npm。同时，您需要拥有一个 Apify API Token。

克隆仓库: 在本地克隆 Apify Actors MCP Server 仓库：

git clone https://github.com/apify/actors-mcp-server.git

cd actors-mcp-server

安装依赖: 安装项目所需的 npm 包：
```
npm install
```
构建项目: 构建项目，生成可执行文件：
```
npm run build
```

服务器配置

MCP 服务器需要配置后才能被 MCP 客户端（例如 Claude Desktop）连接和使用。以下是针对不同 MCP 客户端的服务器配置示例，您需要将这些配置信息填入到您的 MCP 客户端中。

针对 Claude Desktop 的配置 (JSON 格式):

打开 Claude Desktop 的开发者配置 (Edit Config)，在 'mcpServers' 字段下添加以下配置：

{
  "mcpServers": {
    "apify-actors": {  //  服务器名称，可以自定义，用于在客户端中标识
      "command": "npx", //  启动服务器的命令，这里使用 npx 执行 npm 包
      "args": [
        "-y",
        "@apify/actors-mcp-server" //  服务器 npm 包名，默认启动 Stdio 服务器
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN" //  您的 Apify API Token，用于访问 Apify 平台
      }
    }
  }
}

如果您希望在服务器启动时加载特定的 Apify Actors 作为工具，可以通过 '--actors' 参数指定，例如：

{
  "mcpServers": {
    "apify-actors": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors", "apify/google-search-scraper,apify/instagram-scraper" //  指定启动时加载的 Apify Actors，用逗号分隔
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

请将 'YOUR_APIFY_TOKEN' 替换为您实际的 Apify API Token。

基本使用方法

启动服务器:
- 本地 Stdio 服务器: 配置 Claude Desktop 后，重启 Claude Desktop 即可自动启动本地 Stdio 服务器。
- 云端 SSE 服务器: 可以将该项目作为 Apify Actor 部署到 Apify 平台，并使用提供的 SSE Endpoint 与客户端连接。具体部署和启动方式请参考仓库 README 文档。
客户端连接:
- Claude Desktop: 配置完成后，Claude Desktop 将自动连接到 MCP 服务器。您可以在 Claude Desktop 中通过提问来测试工具是否可用，例如询问 "What Apify Actors I can use?"。
- 其他 MCP 客户端: 根据客户端的要求，配置服务器连接信息（如 SSE Endpoint 或 Stdio 命令），并使用 Apify API Token 进行鉴权。
使用工具:
连接成功后，您可以向 LLM 客户端提出需要使用工具才能完成的任务，例如：
- "Search web and summarize recent trends about AI Agents"
- "Find top 10 best Italian restaurants in San Francisco"
- "Find and analyze Instagram profile of The Rock" LLM 客户端会根据您的指令，自动调用 Apify Actors 工具来完成相应的任务。

关键词