APIFY-MCP-服务器
项目介绍
位于 mcp.apify.com 的 Apify 模型上下文协议 (MCP) 服务器使您的 AI 代理能够从社交媒体、搜索引擎、地图、电子商务网站或任何其他网站中提取数据，使用 Apify 商店上提供的数千个现成的抓取器、爬虫和自动化工具。
🚀 尝试托管的 Apify MCP 服务器！
为了最简单的设置和最强大的功能，包括能够找到并使用 Apify 商店中的任何 Actor，请将您的 AI 助手连接到我们的托管服务器：
它支持 OAuth，因此您可以仅通过 URL 从像 Claude.ai 或 Visual Studio Code 这样的客户端进行连接。
目录
- 🌐 介绍 Apify MCP 服务器
- 🚀 快速开始
- 🤖 MCP 客户端和示例
- 🪄 即刻尝试 Apify MCP
- 🛠️ 工具、资源和提示
- 🐛 故障排除（本地 MCP 服务器）
- ⚙️ 开发
- 🤝 贡献
- 📚 学习更多
🌐 介绍 Apify MCP 服务器
Apify MCP 服务器允许 AI 助手使用任何 Apify Actor 作为工具来执行特定任务。 例如，它可以：
- 使用 Facebook 帖子抓取器从多个页面/个人资料中提取 Facebook 帖子的数据。
- 使用 Google 地图电子邮件提取器从 Google 地图中提取联系信息。
- 使用 Google 搜索结果抓取器抓取 Google 搜索引擎结果页面 (SERP)。
- 使用 Instagram 抓取器抓取 Instagram 帖子、个人资料、地点、照片和评论。
- 使用 RAG 网络浏览器搜索网络，抓取前 N 个 URL 并返回其内容。
视频教程：集成 8,000 多个 Apify Actor 和代理与 Claude
🚀 快速开始
您可以以两种方式使用 Apify MCP 服务器：
HTTPS 端点（mcp.apify.com）：通过 OAuth 或在请求中包含 Authorization: Bearer <APIFY_TOKEN> 头部从您的 MCP 客户端连接。这是大多数用例推荐的方法。因为它支持 OAuth，所以您可以通过 URL https://mcp.apify.com 从像 Claude.ai 或 Visual Studio Code 这样的客户端进行连接。
https://mcp.apify.com流传输
标准输入/输出（stdio）：适用于本地集成和命令行工具，如桌面版 Claude 客户端。
- 设置 MCP 客户端服务器命令为
npx @apify/actors-mcp-server，并将APIFY_TOKEN环境变量设置为您自己的 Apify API 令牌。 - 查看
npx @apify/actors-mcp-server --help获取更多选项。
您可以在 Apify 文档 中找到有关设置 MCP 服务器的详细说明。
🤖 MCP 客户端
Apify MCP 服务器兼容任何遵循 模型上下文协议 的 MCP 客户端，但不同客户端对动态工具发现和其他功能的支持程度可能有所不同。
<!--因此，服务器使用 [mcp-client-capabilities](https://github.com/apify/mcp-client-capabilities) 来检测客户端能力并相应地调整其行为。-->要与 Apify MCP 服务器交互，您可以使用以下客户端：Claude Desktop，Visual Studio Code 或 Apify Tester MCP 客户端。
访问 mcp.apify.com 以根据您的首选客户端配置服务器。
支持的客户端矩阵
下表概述了已测试的 MCP 客户端及其对关键功能的支持程度。
| 客户端 | 动态工具发现 | 备注 |
|---|---|---|
| Claude.ai (web) | 🟡 部分 | 工具可能需要手动重新加载到客户端中 |
| Claude Desktop | 🟡 部分 | 工具可能需要手动重新加载到客户端中 |
| VS Code (Genie) | ✅ 全面 | |
| Cursor | ✅ 全面 | |
| Apify Tester MCP 客户端 | ✅ 全面 | 设计用于测试 Apify MCP 服务器 |
| OpenCode | ✅ 全面 |
基于客户端能力的智能工具选择：
当请求 actors 工具类别时，服务器会根据客户端的能力智能地选择最合适的 Actor 相关工具：
-
具有动态工具支持的客户端（例如，Claude.ai web，VS Code Genie）：服务器提供
add-actor工具而不是call-actor。这允许用户在对话过程中动态发现并添加新的 Actor 作为工具，从而获得更好的用户体验。 -
具有有限动态工具支持的客户端（例如，Claude Desktop）：服务器提供标准的
call-actor工具以及其他 Actor 类别的工具，确保兼容性同时保持功能。
🪄 即刻尝试 Apify MCP
想在无需设置的情况下尝试 Apify MCP 吗？
这个互动的聊天界面提供了一种简单的方式来探索 Apify MCP 的功能，无需本地设置。 只需使用您的 Apify 账户登录，即可开始实验网络抓取、数据提取和自动化工具！
或者使用 MCP 包文件（以前称为 Anthropic Desktop 扩展文件，或 DXT）进行一键安装：Apify MCP 服务器 MCPB 文件
🛠️ 工具、资源和提示
MCP 服务器提供一组工具来与 Apify Actor 交互。 由于 Apify 商店很大且增长迅速，MCP 服务器提供了一种动态发现和使用新 Actor 的方法。
Actor
任何 Apify Actor 都可以作为工具使用。
默认情况下，服务器预配置了一个 Actor，apify/rag-web-browser，以及几个辅助工具。
MCP 服务器加载 Actor 的输入模式并创建相应的 MCP 工具。
这使得 AI 代理知道要传递给 Actor 的确切参数以及期望的返回值。
例如，对于 apify/rag-web-browser Actor，输入参数是：
{
"query": "旧金山的餐厅",
"maxResults": 3
}
您不需要手动指定要调用哪个 Actor 或其输入参数；LLM 会自动处理这些。 当调用一个工具时，参数会由 LLM 自动传递给 Actor。 您可以参考特定 Actor 的文档获取可用参数列表。
辅助工具
使用 MCP 与 Apify 结合的最大优势之一是动态工具发现。 它赋予了 AI 代理按需查找新工具（Actor）并将其整合的能力。 这里是一些特殊的 MCP 操作以及 Apify MCP 服务器如何支持它们：
- Apify Actor：搜索 Actor，查看其详细信息，并将其作为工具用于 AI。
- Apify 文档：搜索 Apify 文档并获取特定文档以向 AI 提供上下文。
- Actor 运行：获取 Actor 运行列表，检查其详细信息并检索日志。
- Apify 存储：访问数据集和键值存储中的数据。
可用工具概览
这里是 Apify MCP 服务器提供的所有工具的概览列表。
| 工具名称 | 分类 | 描述 | 默认启用 |
|---|---|---|---|
search-actors | actors | 在 Apify 商店中搜索 Actor。 | ✅ |
fetch-actor-details | actors | 获取特定 Actor 的详细信息。 | ✅ |
call-actor* | actors | 调用 Actor 并获取其运行结果。 | ❔ |
apify-slash-rag-web-browser | Actor（参见 工具配置） | 用于浏览网络的 Actor 工具。 | ✅ |
search-apify-docs | docs | 搜索 Apify 文档的相关页面。 | ✅ |
fetch-apify-docs | docs | 根据 URL 获取 Apify 文档页面的完整内容。 | ✅ |
get-actor-run | runs | 获取特定 Actor 运行的详细信息。 | |
get-actor-run-list | runs | 获取 Actor 的运行列表，可按状态过滤。 | |
get-actor-log | runs | 获取特定 Actor 运行的日志。 | |
get-dataset | storage | 获取特定数据集的元数据。 | |
get-dataset-items | storage | 从数据集中检索项目，支持过滤和分页。 | |
get-dataset-schema | storage | 从数据集项目生成 JSON 模式。 | |
get-key-value-store | storage | 获取特定键值存储的元数据。 | |
get-key-value-store-keys | storage | 列出特定键值存储中的键。 | |
get-key-value-store-record | storage | 获取特定键值存储中某个键的值。 | |
get-dataset-list | storage | 列出用户的所有可用数据集。 | |
get-key-value-store-list | storage | 列出用户的所有可用键值存储。 | |
add-actor* | 实验 | 将 Actor 添加为用户可以调用的新工具。 | ❔ |
get-actor-output* | - | 从 Actor 调用中检索未包含在 Actor 工具输出预览中的输出。 | ✅ |
注意：
当使用
actors工具类别时，支持动态工具发现的客户端（如 Claude.ai web 和 VS Code）会自动接收add-actor工具而不是call-actor，以增强 Actor 发现能力。
get-actor-output工具会自动包含在任何与 Actor 相关的工具中，如call-actor、add-actor或任何特定的 Actor 工具，如apify-slash-rag-web-browser。当你调用一个 Actor——无论是通过call-actor工具还是直接通过 Actor 工具（例如apify-slash-rag-web-browser）——你会收到输出的预览。预览取决于 Actor 输出的格式和长度；对于某些 Actor 和运行，它可能会包含整个输出，而对于其他情况，则只返回有限版本以避免压垮 LLM。要获取 Actor 运行的完整输出，请使用get-actor-output工具（支持限制、偏移和字段过滤），并使用 Actor 调用提供的datasetId。
工具注释
所有工具都包含元数据注释，以帮助 MCP 客户端和 LLM 理解工具的行为：
title：工具的短显示名称（例如，“搜索 Actor”，“调用 Actor”，“apify/rag-web-browser”）readOnlyHint：true表示工具仅读取数据而不修改状态（例如，get-dataset，fetch-actor-details）openWorldHint：true表示工具访问 Apify 平台之外的外部资源（例如，call-actor执行外部 Actor，get-html-skeleton抓取外部网站）。仅与 Apify 平台交互的工具（如search-actors或fetch-apify-docs）没有此提示。
工具配置
tools 配置参数用于指定加载的工具——要么是类别，要么是具体的工具，以及 Apify Actor。例如，tools=storage,runs 加载两个类别；tools=add-actor 加载一个工具。
如果没有提供查询参数，默认情况下 MCP 服务器会加载以下 tools：
actorsdocsapify/rag-web-browser
如果指定了工具参数，只有列出的工具或类别会被启用——不会包含默认工具。
简易配置：
使用 UI 配置器 配置您的服务器，然后将配置复制到您的客户端。
配置托管服务器：
托管服务器可以通过 URL 中的查询参数进行配置。例如，要加载默认工具，使用：
https://mcp.apify.com?tools=actors,docs,apify/rag-web-browser
对于最小配置，如果您只想使用单一 Actor 工具——而没有任何发现或通用调用工具，服务器可以这样配置：
https://mcp.apify.com?tools=apify/my-actor
这种设置仅暴露指定的 Actor (apify/my-actor) 作为工具。没有其他工具可用。
配置 CLI：
CLI 可以通过命令行标志进行配置。例如，要加载与托管服务器配置相同的工具，使用：
npx @apify/actors-mcp-server --tools actors,docs,apify/rag-web-browser
最小配置类似于托管服务器配置：
npx @apify/actors-mcp-server --tools apify/my-actor
同样，这仅暴露指定的 Actor (apify/my-actor) 作为工具。没有其他工具可用。
⚠️ 重要建议
默认工具配置在未来版本中可能会更改。 当未指定
tools参数时，服务器当前加载默认工具，但此行为可能会改变。对于生产用途和稳定的接口，始终显式指定
tools参数 以确保您的配置在更新后保持一致。
向后兼容性
v2 配置保留了