演员-MCP服务器
项目介绍
Apify 模型上下文协议（MCP）服务器位于 mcp.apify.com，它使您的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 Web浏览器搜索网络，抓取前N个URL，并返回其内容。
视频教程：集成8000+ Apify Actor和代理与Claude
🚀 快速开始
您可以通过两种方式使用Apify MCP服务器：
HTTPS端点（mcp.apify.com）：通过OAuth从您的MCP客户端连接，或者在请求中包含Authorization: Bearer <APIFY_TOKEN>头。这是大多数用例推荐的方法。因为它支持OAuth，所以您可以仅通过URL从客户端如Claude.ai或Visual Studio Code进行连接：https://mcp.apify.com。
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（网页） | 🟡 部分 | 工具可能需要手动重新加载到客户端中 |
| Claude Desktop | 🟡 部分 | 工具可能需要手动重新加载到客户端中 |
| VS Code（Genie） | ✅ 全面 | |
| Cursor | ✅ 全面 | |
| Apify Tester MCP客户端 | ✅ 全面 | 设计用于测试Apify MCP服务器 |
| OpenCode | ✅ 全面 |
基于客户端能力的智能工具选择：
当请求actors工具类别时，服务器会根据客户端的能力智能选择最合适的Actor相关工具：
-
具有动态工具支持的客户端（例如，Claude.ai网页，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-browserActor，输入参数是：
{
"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* | experimental | 将Actor作为新工具添加给用户调用。 | ❔ |
get-actor-output* | - | 获取Actor调用的输出，该输出不包含在Actor工具的输出预览中。 | ✅ |
注意：
当使用
actors工具类别时，支持动态工具发现的客户端（如Claude.ai网页和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配置保留了与v1使用的向后兼容性。注意事项：
actors参数（URL）和--actors标志（CLI）仍然受支持。- 内部它们合并为
tools选择器。 - 示例：
?actors=apify/rag-web-browser≡?tools=apify/rag-web-browser；--actors apify/rag-web-browser≡--tools apify/rag-web-browser。
- 内部它们合并为
enable-adding-actors（CLI）和enableAddingActors（URL）受支持但已弃用。- 建议使用
tools=experimental或包含特定工具tools=add-actor。 - 行为保持不变：当启用且未指定
tools时，服务器仅暴露add-actor；当选择类别/工具时，add-actor也会被包含。
- 建议使用
enableActorAutoLoading仍作为`enable