@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.
Files changed (2) hide show
  1. package/README.md +25 -6
  2. 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
  [![Actors MCP Server](https://apify.com/actor-badge?actor=apify/actors-mcp-server)](https://apify.com/apify/actors-mcp-server)
4
+ [![smithery badge](https://smithery.ai/badge/@apify/actors-mcp-server)](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
  ![Actors-MCP-server](https://raw.githubusercontent.com/apify/actors-mcp-server/refs/heads/master/docs/actors-mcp-server.png)
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-january-2025) for more details.
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 ass [Superinference.ai](https://superinterface.ai/) or [LibreChat](https://www.librechat.ai/) support SSE with custom headers.
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 (January 2025)
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)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@apify/actors-mcp-server",
3
- "version": "0.1.9",
3
+ "version": "0.1.10-beta.1",
4
4
  "type": "module",
5
5
  "description": "Model Context Protocol Server for Apify Actors",
6
6
  "engines": {