Updating PR #29 with required changes

Author: jirispilka

.actor/input_schema.json

@@ -14,6 +14,19 @@
                 "lukaskrivka/google-maps-with-contact-details"
             ]
         },
+        "enableActorAutoLoading": {
+            "title": "Enable automatic loading of Actors based on context and use-case (experimental, check if it supported by your client)",
+            "type": "boolean",
+            "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": {
+            "title": "Limit the maximum memory used by an Actor",
+            "type": "integer",
+            "description": "Limit the maximum memory used by an Actor in bytes. This is important setting for Free plan users to avoid exceeding the memory limit.",
+            "prefill": 4096,
+            "default": 4096
+        },
         "debugActor": {
             "title": "Debug Actor",
             "type": "string",
@@ -28,7 +41,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"
             }
         }
     }

CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All notable changes to this project will be documented in this file.
 
+<!-- git-cliff-unreleased-start -->
+## 0.1.10 - **not yet released**
+
+### 🚀 Features
+
+- Update README with a link to relevant blogposts ([#34](https://github.com/apify/actors-mcp-server/pull/34)) ([a7c8ea2](https://github.com/apify/actors-mcp-server/commit/a7c8ea24da243283195822d16b56f135786866f4)) by [@jirispilka](https://github.com/jirispilka)
+
+### 🐛 Bug Fixes
+
+- Update README.md ([#33](https://github.com/apify/actors-mcp-server/pull/33)) ([d053c63](https://github.com/apify/actors-mcp-server/commit/d053c6381939e46da7edce409a529fd1581a8143)) by [@RVCA212](https://github.com/RVCA212)
+
+
+<!-- git-cliff-unreleased-end -->
+## [0.1.9](https://github.com/apify/actors-mcp-server/releases/tag/v0.1.9) (2025-02-07)
+
+### 🐛 Bug Fixes
+
+- Stdio and SSE example, improve logging ([#32](https://github.com/apify/actors-mcp-server/pull/32)) ([1b1852c](https://github.com/apify/actors-mcp-server/commit/1b1852cdb49c5de3f8dd48a1d9abc5fd28c58b3a)) by [@jirispilka](https://github.com/jirispilka)
+
+
+## [0.1.8](https://github.com/apify/actors-mcp-server/releases/tag/v0.1.8) (2025-01-31)
+
+### 🐛 Bug Fixes
+
+- Actor auto loading (corret tool-&gt;Actor name conversion) ([#31](https://github.com/apify/actors-mcp-server/pull/31)) ([45073ea](https://github.com/apify/actors-mcp-server/commit/45073ea49f56784cc4e11bed84c01bcb136b2d8e)) by [@jirispilka](https://github.com/jirispilka)
+
+
+## [0.1.7](https://github.com/apify/actors-mcp-server/releases/tag/v0.1.7) (2025-01-30)
+
+### 🐛 Bug Fixes
+
+- Add internal tools for Actor discovery ([#28](https://github.com/apify/actors-mcp-server/pull/28)) ([193f098](https://github.com/apify/actors-mcp-server/commit/193f0983255d8170c90109d162589e62ec10e340)) by [@jirispilka](https://github.com/jirispilka)
+- Update README.md ([#30](https://github.com/apify/actors-mcp-server/pull/30)) ([23bb32e](https://github.com/apify/actors-mcp-server/commit/23bb32e1f2d5b10d3d557de87cb2d97b5e81921b)) by [@jirispilka](https://github.com/jirispilka)
+
+
 ## [0.1.6](https://github.com/apify/actors-mcp-server/releases/tag/v0.1.6) (2025-01-23)
 
 ### 🐛 Bug Fixes

docs/actors-mcp-server.png

@@ -1,6 +1,6 @@
 {
   "name": "@apify/actors-mcp-server",
-  "version": "0.1.6",
+  "version": "0.1.10",
   "type": "module",
   "description": "Model Context Protocol Server for Apify Actors",
   "engines": {
@@ -35,7 +35,9 @@
     "apify": "^3.2.6",
     "apify-client": "^2.11.1",
     "express": "^4.21.2",
-    "minimist": "^1.2.8"
+    "minimist": "^1.2.8",
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.1"
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.33.1",

package-lock.json

@@ -1,9 +1,17 @@
 import { Ajv } from 'ajv';
 import { ApifyClient } from 'apify-client';
 
-import { MAX_DESCRIPTION_LENGTH, MAX_ENUM_LENGTH, MAX_MEMORY_MBYTES } 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';
+import type { ActorDefinitionPruned, ActorDefinitionWithDesc, SchemaProperties, Tool } from './types.js';
+
+export function actorNameToToolName(actorName: string): string {
+    return actorName.replace('/', '--');
+}
+
+export function toolNameToActorName(toolName: string): string {
+    return toolName.replace('--', '/');
+}
 
 /**
  * Get actor input schema by actor name.
@@ -12,11 +20,7 @@ import type { ActorDefinitionWithDesc, SchemaProperties, Tool } from './types.js
  * @param {string} actorFullName - The full name of the actor.
  * @returns {Promise<ActorDefinitionWithDesc | null>} - The actor definition with description or null if not found.
  */
-async function fetchActorDefinition(actorFullName: string): Promise<ActorDefinitionWithDesc | null> {
-    if (!process.env.APIFY_TOKEN) {
-        log.error('APIFY_TOKEN is required but not set. Please set it as an environment variable');
-        return null;
-    }
+export async function getActorDefinition(actorFullName: string): Promise<ActorDefinitionPruned | null> {
     const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
     const actorClient = client.actor(actorFullName);
 
@@ -43,32 +47,37 @@ async function fetchActorDefinition(actorFullName: string): Promise<ActorDefinit
         if (buildDetails?.actorDefinition) {
             const actorDefinitions = buildDetails?.actorDefinition as ActorDefinitionWithDesc;
             actorDefinitions.description = actor.description || '';
-            actorDefinitions.name = actorFullName;
+            actorDefinitions.actorFullName = actorFullName;
             actorDefinitions.defaultRunOptions = actor.defaultRunOptions;
-            return actorDefinitions;
+            return pruneActorDefinition(actorDefinitions);
         }
         return null;
     } catch (error) {
         log.error(`Failed to fetch input schema for actor: ${actorFullName} with error ${error}.`);
-        return null;
+        throw new Error(`Failed to fetch input schema for actor: ${actorFullName} with error ${error}.`);
     }
 }
 
+function pruneActorDefinition(response: ActorDefinitionWithDesc): ActorDefinitionPruned {
+    return {
+        actorFullName: response.actorFullName || '',
+        buildTag: response?.buildTag || '',
+        readme: response?.readme || '',
+        input: response?.input || null,
+        description: response.description,
+        defaultRunOptions: response.defaultRunOptions,
+    };
+}
+
 /**
  * Shortens the description and enum values of schema properties.
  * @param properties
  */
-function shortenProperties(properties: { [key: string]: SchemaProperties}): { [key: string]: SchemaProperties } {
+export function shortenProperties(properties: { [key: string]: SchemaProperties}): { [key: string]: SchemaProperties } {
     for (const property of Object.values(properties)) {
         if (property.description.length > MAX_DESCRIPTION_LENGTH) {
             property.description = `${property.description.slice(0, MAX_DESCRIPTION_LENGTH)}...`;
         }
-        if (property.enum) {
-            property.enum = property.enum.slice(0, MAX_ENUM_LENGTH);
-        }
-        if (property.enumTitles) {
-            property.enumTitles = property.enumTitles.slice(0, MAX_ENUM_LENGTH);
-        }
     }
     return properties;
 }
@@ -77,11 +86,11 @@ function shortenProperties(properties: { [key: string]: SchemaProperties}): { [k
  * Filters schema properties to include only the necessary fields.
  * @param properties
  */
-function filterSchemaProperties(properties: { [key: string]: SchemaProperties }): { [key: string]: SchemaProperties } {
+export function filterSchemaProperties(properties: { [key: string]: SchemaProperties }): { [key: string]: SchemaProperties } {
     const filteredProperties: { [key: string]: SchemaProperties } = {};
     for (const [key, property] of Object.entries(properties)) {
-        const { title, description, enum: enumValues, enumTitles, type, default: defaultValue, prefill } = property;
-        filteredProperties[key] = { title, description, enum: enumValues, enumTitles, type, default: defaultValue, prefill };
+        const { title, description, enum: enumValues, type, default: defaultValue, prefill } = property;
+        filteredProperties[key] = { title, description, enum: enumValues, type, default: defaultValue, prefill };
     }
     return filteredProperties;
 }
@@ -98,9 +107,8 @@ function filterSchemaProperties(properties: { [key: string]: SchemaProperties })
  * @returns {Promise<Tool[]>} - A promise that resolves to an array of MCP tools.
  */
 export async function getActorsAsTools(actors: string[]): Promise<Tool[]> {
-    // Fetch input schemas in parallel
     const ajv = new Ajv({ coerceTypes: 'array', strict: false });
-    const results = await Promise.all(actors.map(fetchActorDefinition));
+    const results = await Promise.all(actors.map(getActorDefinition));
     const tools = [];
     for (const result of results) {
         if (result) {
@@ -109,17 +117,17 @@ export async function getActorsAsTools(actors: string[]): Promise<Tool[]> {
                 result.input.properties = shortenProperties(properties);
             }
             try {
-                const memoryMbytes = result.defaultRunOptions?.memoryMbytes || MAX_MEMORY_MBYTES;
+                const memoryMbytes = result.defaultRunOptions?.memoryMbytes || defaults.maxMemoryMbytes;
                 tools.push({
-                    name: result.name.replace('/', '_'),
-                    actorName: result.name,
-                    description: result.description,
+                    name: actorNameToToolName(result.actorFullName),
+                    actorFullName: result.actorFullName,
+                    description: `${result.description} Instructions: ${ACTOR_ADDITIONAL_INSTRUCTIONS}`,
                     inputSchema: result.input || {},
                     ajvValidate: ajv.compile(result.input || {}),
-                    memoryMbytes: memoryMbytes > MAX_MEMORY_MBYTES ? MAX_MEMORY_MBYTES : memoryMbytes,
+                    memoryMbytes: memoryMbytes > defaults.maxMemoryMbytes ? defaults.maxMemoryMbytes : memoryMbytes,
                 });
             } catch (validationError) {
-                log.error(`Failed to compile AJV schema for actor: ${result.name}. Error: ${validationError}`);
+                log.error(`Failed to compile AJV schema for actor: ${result.actorFullName}. Error: ${validationError}`);
             }
         }
     }

package.json

@@ -2,12 +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_ENUM_LENGTH = 50;
-export const MAX_DESCRIPTION_LENGTH = 200;
-// Limit memory to 4GB for Actors. Free users have 8 GB limit, but we need to reserve some memory for Actors-MCP-Server too
-export const MAX_MEMORY_MBYTES = 4096;
-
+export const MAX_DESCRIPTION_LENGTH = 500;
 export const USER_AGENT_ORIGIN = 'Origin/mcp-server';
 
 export const defaults = {
@@ -16,11 +11,22 @@ export const defaults = {
         'apify/rag-web-browser',
         'lukaskrivka/google-maps-with-contact-details',
     ],
+    enableActorAutoLoading: false,
+    maxMemoryMbytes: 4096,
 };
 
-export const ACTOR_OUTPUT_MAX_CHARS_PER_ITEM = 2_000;
+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',
+    ADD_ACTOR_TO_TOOLS = 'add-actor-to-tools',
+    REMOVE_ACTOR_FROM_TOOLS = 'remove-actor-from-tools',
+    GET_ACTOR_DETAILS = 'get-actor-details',
+}
 
 export enum Routes {
     ROOT = '/',

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

@@ -3,6 +3,7 @@
  * Connect to the MCP server using SSE transport and call a tool.
  * The Actors MCP Server will load default Actors.
  *
+ * It requires the `APIFY_TOKEN` in the `.env` file.
  */
 
 import path from 'path';
@@ -15,15 +16,14 @@ import dotenv from 'dotenv';
 import { EventSource } from 'eventsource';
 
 const REQUEST_TIMEOUT = 120_000; // 2 minutes
-// Resolve dirname equivalent in ES module
 const filename = fileURLToPath(import.meta.url);
 const dirname = path.dirname(filename);
 
 dotenv.config({ path: path.resolve(dirname, '../../.env') });
 
 const SERVER_URL = 'https://actors-mcp-server.apify.actor/sse';
-// We need to change forward slash / to underscore _ in the tool name as Anthropic does not allow forward slashes in the tool name
-const SELECTED_TOOL = 'apify_rag-web-browser';
+// We need to change forward slash / to underscore -- in the tool name as Anthropic does not allow forward slashes in the tool name
+const SELECTED_TOOL = 'apify--rag-web-browser';
 const QUERY = 'web browser for Anthropic';
 
 if (!process.env.APIFY_TOKEN) {

src/const.ts

@@ -24,7 +24,7 @@ const SERVER_PATH = path.resolve(dirname, '../../dist/index.js');
 const NODE_PATH = execSync(process.platform === 'win32' ? 'where node' : 'which node').toString().trim();
 
 const TOOLS = 'apify/rag-web-browser,lukaskrivka/google-maps-with-contact-details';
-const SELECTED_TOOL = 'apify_rag-web-browser'; // We need to change / to _ in the tool name
+const SELECTED_TOOL = 'apify--rag-web-browser'; // We need to change / to _ in the tool name
 
 if (!process.env.APIFY_TOKEN) {
     console.error('APIFY_TOKEN is required but not set in the environment variables.');

src/examples/clientSse.ts

@@ -23,6 +23,11 @@ log.setLevel(log.LEVELS.ERROR);
 const argv = minimist(process.argv.slice(2));
 const argActors = argv.actors?.split(',').map((actor: string) => actor.trim()) || [];
 
+if (!process.env.APIFY_TOKEN) {
+    log.error('APIFY_TOKEN is required but not set in the environment variables.');
+    process.exit(1);
+}
+
 async function main() {
     const server = new ApifyMcpServer();
     await (argActors.length !== 0