Move client to a separate repository. Update README.md

Author: jirispilka

.actor/input_schema.json

@@ -14,10 +14,10 @@
                 "lukaskrivka/google-maps-with-contact-details"
             ]
         },
-        "enableActorDiscovery": {
-            "title": "Enable Actor discovery based on your use-case (experimental)",
+        "enableActorAutoLoading": {
+            "title": "Enable automatic loading of Actors based on context and use-case (experimental, check if it supported by your client)",
             "type": "boolean",
-            "description": "If enabled, the server will automatically discover available Actors for your use case.\n\nThis feature is experimental and may not work as expected.",
+             "description": "When enabled, the server can dynamically add Actors as tools based on user requests and context. \n\nNote: Not all MCP clients support this feature. To try it, you can use the [Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client). This is an experimental feature and may require client-specific support.",
             "default": false
         },
         "maxActorMemoryBytes": {
@@ -42,7 +42,7 @@
             "description": "Specify the input for the Actor that will be used for debugging in normal mode",
             "editor": "json",
             "prefill": {
-                "query": "hello world"
+            "query": "hello world"
             }
         }
     }

README.md

@@ -6,8 +6,8 @@ Implementation of an MCP server for all [Apify Actors](https://apify.com/store).
 This server enables interaction with one or more Apify Actors that can be defined in the MCP Server configuration.
 
 The server can be used in two ways:
-- 🇦 **Apify MCP Server Actor**: runs an HTTP server with MCP protocol via Server-Sent Events.
-- ⾕ **Apify MCP Server Stdio**: provides support for the MCP protocol via standard input/output stdio.
+- 🇦 **Apify MCP Server Actor**: runs an HTTP server with MCP and can be accessed via Server-Sent Events (SSE).
+- ⾕ **Apify MCP Server Stdio**: runs the server locally with MCP via standard input/output (stdio).
 
 # 🎯 What does Apify MCP server do?
 
@@ -19,8 +19,15 @@ For example it can:
 - use [Instagram Scraper](https://apify.com/apify/instagram-scraper) to scrape Instagram posts, profiles, places, photos, and comments
 - use [RAG Web Browser](https://apify.com/apify/web-scraper) to search the web, scrape the top N URLs, and return their content
 
+# MCP Clients
+
+To interact with the Apify MCP server, you can use MCP clients such as:
+- [Claude Desktop](https://claude.ai/download) (only Stdio support)
+- [LibreChat](https://www.librechat.ai/) (stdio and SSE support (yeah without Authorization header))
+- [Apify Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client) (SSE support with Authorization headers)
+- other clients at [https://modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients)
+- more clients at [https://glama.ai/mcp/clients](https://glama.ai/mcp/clients)
 
-To interact with the Apify MCP server, you can use MCP clients such as [Claude Desktop](https://claude.ai/download), [LibreChat](https://www.librechat.ai/), or other [MCP clients](https://glama.ai/mcp/clients).
 Additionally, you can use simple example clients found in the [examples](https://github.com/apify/actor-mcp-server/tree/main/src/examples) directory.
 
 When you have Actors integrated with the MCP server, you can ask:
@@ -54,6 +61,8 @@ To learn more, check out the blog post: [What are AI Agents?](https://blog.apify
 
 ## Tools
 
+### Actors
+
 Any [Apify Actor](https://apify.com/store) can be used as a tool.
 By default, the server is pre-configured with the Actors specified below, but it can be overridden by providing Actor input.
 
@@ -79,6 +88,19 @@ You don't need to specify the input parameters or which Actor to call, everythin
 When a tool is called, the arguments are automatically passed to the Actor by the LLM.
 You can refer to the specific Actor's documentation for a list of available arguments.
 
+### Helper tools
+
+The server provides a set of helper tools to discover available Actors and retrieve their details:
+- `get-actor-details`: Retrieves documentation, input schema, and other details about a specific Actor.
+- `discover-actors`: Searches for relevant Actors using keywords and returns their details.
+
+There are also tools to manage the available tools list. However, dynamically adding and removing tools requires the MCP client to have the capability to manage the tools list, which is typically not supported.
+
+You can try this functionality using the [Apify Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client) Actor. To enable it, set the `enableActorAutoLoading` parameter.
+
+- `add-actor-as-tool`: Adds an Actor by name to the available tools list without executing it, requiring user consent to run later.
+- `remove-actor-from-tool`: Removes an Actor by name from the available tools list when it's no longer needed.
+
 ## Prompt & Resources
 
 The server does not provide any resources and prompts.

docs/actors-mcp-server.png

@@ -1,7 +1,7 @@
 import { Ajv } from 'ajv';
 import { ApifyClient } from 'apify-client';
 
-import { defaults, MAX_DESCRIPTION_LENGTH } from './const.js';
+import { ACTOR_ADDITIONAL_INSTRUCTIONS, defaults, MAX_DESCRIPTION_LENGTH } from './const.js';
 import { log } from './logger.js';
 import type { ActorDefinitionWithDesc, SchemaProperties, Tool } from './types.js';
 
@@ -106,7 +106,7 @@ export async function getActorsAsTools(actors: string[]): Promise<Tool[]> {
                 tools.push({
                     name: result.name.replace('/', '_'),
                     actorName: result.name,
-                    description: result.description,
+                    description: `${result.description} Instructions: ${ACTOR_ADDITIONAL_INSTRUCTIONS}`,
                     inputSchema: result.input || {},
                     ajvValidate: ajv.compile(result.input || {}),
                     memoryMbytes: memoryMbytes > defaults.maxMemoryMbytes ? defaults.maxMemoryMbytes : memoryMbytes,

src/actorDefinition.ts renamed to src/actors.ts

@@ -2,10 +2,7 @@ export const SERVER_NAME = 'apify-mcp-server';
 export const SERVER_VERSION = '0.1.0';
 
 export const HEADER_READINESS_PROBE = 'x-apify-container-server-readiness-probe';
-
 export const MAX_DESCRIPTION_LENGTH = 500;
-export const MAX_TOOL_CALL_COUNT = 10;
-
 export const USER_AGENT_ORIGIN = 'Origin/mcp-server';
 
 export const defaults = {
@@ -14,12 +11,15 @@ export const defaults = {
         'apify/rag-web-browser',
         'lukaskrivka/google-maps-with-contact-details',
     ],
-    maxMemoryMbytes: 4098,
+    enableActorAutoLoading: false,
+    maxMemoryMbytes: 4096,
 };
 
 export const ACTOR_OUTPUT_MAX_CHARS_PER_ITEM = 5_000;
 export const ACTOR_OUTPUT_TRUNCATED_MESSAGE = `Output was truncated because it will not fit into context.`
-    + ` There is no reason to call this tool again!`;
+    + `There is no reason to call this tool again!`;
+export const ACTOR_ADDITIONAL_INSTRUCTIONS = 'Never call/execute tool/Actor unless confirmed by the user. '
+    + 'Always limit the number of results in the call arguments.';
 
 export enum InternalTools {
     DISCOVER_ACTORS = 'discover-actors',