@apify/actors-mcp-server 0.1.9 → 0.1.10-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
# Apify Model Context Protocol (MCP) Server
|
|
2
2
|
|
|
3
3
|
[](https://apify.com/apify/actors-mcp-server)
|
|
4
|
+
[](https://smithery.ai/server/@apify/actors-mcp-server)
|
|
4
5
|
|
|
5
6
|
Implementation of an MCP server for all [Apify Actors](https://apify.com/store).
|
|
6
7
|
This server enables interaction with one or more Apify Actors that can be defined in the MCP Server configuration.
|
|
7
8
|
|
|
8
9
|
The server can be used in several ways:
|
|
9
|
-
- **🇦 MCP Server Actor** – HTTP server accessible via Server-Sent Events (SSE).
|
|
10
|
+
- **🇦 [MCP Server Actor](https://apify.com/apify/actors-mcp-server)** – HTTP server accessible via Server-Sent Events (SSE).
|
|
10
11
|
- **⾕ MCP Server Stdio** – Local server available via standard input/output (stdio).
|
|
11
12
|
- **💬 [Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client)** – Chat-like UI for interacting with the MCP server.
|
|
12
13
|
|
|
@@ -43,20 +44,20 @@ The following image shows how the Apify MCP server interacts with the Apify plat
|
|
|
43
44
|

|
|
44
45
|
|
|
45
46
|
In the future, we plan to load Actors dynamically and provide Apify's dataset and key-value store as resources.
|
|
46
|
-
See the [Roadmap](#-roadmap-
|
|
47
|
+
See the [Roadmap](#-roadmap-march-2025) for more details.
|
|
47
48
|
|
|
48
49
|
# 🔄 What is the Model Context Protocol?
|
|
49
50
|
|
|
50
51
|
The Model Context Protocol (MCP) allows AI applications (and AI agents), such as Claude Desktop, to connect to external tools and data sources.
|
|
51
52
|
MCP is an open protocol that enables secure, controlled interactions between AI applications, AI Agents, and local or remote resources.
|
|
52
53
|
|
|
53
|
-
For more information, see the [Model Context Protocol](https://modelcontextprotocol.org/) website.
|
|
54
|
+
For more information, see the [Model Context Protocol](https://modelcontextprotocol.org/) website or blogpost [What is MCP and why does it matter?](https://blog.apify.com/what-is-model-context-protocol/).
|
|
54
55
|
|
|
55
56
|
# 🤖 How is Actors MCP Server related to AI Agents?
|
|
56
57
|
|
|
57
58
|
The Apify MCP Server exposes Apify's Actors through the MCP protocol, allowing AI Agents or frameworks that implement the MCP protocol to access all Apify Actors as tools for data extraction, web searching, and other tasks.
|
|
58
59
|
|
|
59
|
-
To learn more, check out the blog post: [What are AI Agents?](https://blog.apify.com/what-are-ai-agents/)
|
|
60
|
+
To learn more, check out the blog post: [What are AI Agents?](https://blog.apify.com/what-are-ai-agents/) and Apify's [AI Agent collection](https://apify.com/store/collections/ai_agents).
|
|
60
61
|
|
|
61
62
|
# 🧱 Components
|
|
62
63
|
|
|
@@ -140,7 +141,7 @@ Once the server is running, you can interact with Server-Sent Events (SSE) to se
|
|
|
140
141
|
The easiest way is to use [Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client) on Apify.
|
|
141
142
|
|
|
142
143
|
Other clients do not support SSE yet, but this will likely change.
|
|
143
|
-
Please verify if MCP clients such
|
|
144
|
+
Please verify if MCP clients such as [Superinference.ai](https://superinterface.ai/) or [LibreChat](https://www.librechat.ai/) support SSE with custom headers.
|
|
144
145
|
([Claude Desktop](https://claude.ai/download) does not support SSE transport yet, see [Claude Desktop Configuration](#claude-desktop) section for more details).
|
|
145
146
|
|
|
146
147
|
In the client settings you need to provide server configuration:
|
|
@@ -197,6 +198,9 @@ Alternatively, you can use simple python [client_see.py](https://github.com/apif
|
|
|
197
198
|
```
|
|
198
199
|
|
|
199
200
|
## ⾕ MCP Server at a local host
|
|
201
|
+
``
|
|
202
|
+
You can run the Apify MCP Server on your local machine by configuring it with Claude Desktop or any other [MCP clients](https://modelcontextprotocol.io/clients).
|
|
203
|
+
You can also use [Smithery](https://smithery.ai/server/@apify/actors-mcp-server) to install the server automatically.
|
|
200
204
|
|
|
201
205
|
### Prerequisites
|
|
202
206
|
|
|
@@ -289,6 +293,14 @@ To configure Claude Desktop to work with the MCP server, follow these steps. For
|
|
|
289
293
|
Find and analyze instagram profile of the Rock.
|
|
290
294
|
```
|
|
291
295
|
|
|
296
|
+
### Installing via Smithery
|
|
297
|
+
|
|
298
|
+
To install Apify Actors MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@apify/actors-mcp-server):
|
|
299
|
+
|
|
300
|
+
```bash
|
|
301
|
+
npx -y @smithery/cli install @apify/actors-mcp-server --client claude
|
|
302
|
+
```
|
|
303
|
+
|
|
292
304
|
#### Stdio clients
|
|
293
305
|
|
|
294
306
|
Create environment file `.env` with the following content:
|
|
@@ -369,7 +381,14 @@ Free users have an 8GB limit, 128MB needs to be allocated for running `Actors-MC
|
|
|
369
381
|
|
|
370
382
|
If you need other features or have any feedback, please [submit an issue](https://console.apify.com/actors/1lSvMAaRcadrM1Vgv/issues) in Apify Console to let us know.
|
|
371
383
|
|
|
372
|
-
# 🚀 Roadmap (
|
|
384
|
+
# 🚀 Roadmap (March 2025)
|
|
373
385
|
|
|
374
386
|
- Add Apify's dataset and key-value store as resources.
|
|
375
387
|
- Add tools such as Actor logs and Actor runs for debugging.
|
|
388
|
+
|
|
389
|
+
# References
|
|
390
|
+
|
|
391
|
+
- [Model Context Protocol](https://modelcontextprotocol.org/)
|
|
392
|
+
- [What are AI Agents?](https://blog.apify.com/what-are-ai-agents/)
|
|
393
|
+
- [What is MCP and why does it matter?](https://blog.apify.com/what-is-model-context-protocol/)
|
|
394
|
+
- [Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client)
|