feat: Decouple Actor from mcp-server, add ability to call Actorized MCP and load tools (#59)

---------

Co-authored-by: Jiří Spilka <[email protected]>

Author: MQ37

.actor/ACTOR.md

@@ -5,6 +5,7 @@
   "description": "Implementation of a Model Context Protocol (MCP) Server for Apify Actors that enables AI applications (and AI agents) to interact with Apify Actors",
   "version": "0.1",
   "input": "./input_schema.json",
+  "readme": "./ACTOR.md",
   "dockerfile": "./Dockerfile",
   "webServerMcpPath": "/sse"
 }

.actor/actor.json

@@ -1,6 +1,6 @@
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
+const { execSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
 
 const PKG_JSON_PATH = path.join(__dirname, '..', '..', 'package.json');
 

.github/scripts/before-beta-release.cjs

@@ -36,3 +36,6 @@ jobs:
 
             -   name: Test
                 run: npm run test
+
+            -   name: Type checks
+                run: npm run type-check

.github/workflows/check.yaml

@@ -18,3 +18,4 @@ storage/key_value_stores/default/*
 # Added by Apify CLI
 .venv
 .env
+.aider*

.gitignore

@@ -0,0 +1 @@
+22.13.1

.nvmrc

@@ -179,4 +179,4 @@ All notable changes to this project will be documented in this file.
 ### 🐛 Bug Fixes
 
 - Update express routes to correctly handle GET and HEAD requests, fix CI ([#5](https://github.com/apify/actors-mcp-server/pull/5)) ([ec6e9b0](https://github.com/apify/actors-mcp-server/commit/ec6e9b0a4657f673b3650a5906fe00e66411d7f1)) by [@jirispilka](https://github.com/jirispilka)
-- Correct publishing of npm module ([#6](https://github.com/apify/actors-mcp-server/pull/6)) ([4c953e9](https://github.com/apify/actors-mcp-server/commit/4c953e9fe0c735f1690c8356884dd78d8608979f)) by [@jirispilka](https://github.com/jirispilka)
+- Correct publishing of npm module ([#6](https://github.com/apify/actors-mcp-server/pull/6)) ([4c953e9](https://github.com/apify/actors-mcp-server/commit/4c953e9fe0c735f1690c8356884dd78d8608979f)) by [@jirispilka](https://github.com/jirispilka)

CHANGELOG.md

@@ -10,7 +10,6 @@ The server can be used in two ways:
 - **🇦 [MCP Server Actor](https://apify.com/apify/actors-mcp-server)** – HTTP server accessible via Server-Sent Events (SSE), see [guide](#-mcp-server-actor)
 - **⾕ MCP Server Stdio** – Local server available via standard input/output (stdio), see [guide](#-mcp-server-at-a-local-host)
 
-
 You can also interact with the MCP server using a chat-like UI with 💬 [Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client)
 
 # 🎯 What does Apify MCP server do?
@@ -337,6 +336,63 @@ If you want to specify which Actors to load, you can add the `--actors` argument
 }
 ```
 
+#### VS Code
+
+For one-click installation, click one of the install buttons below:
+
+[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=actors-mcp-server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40apify%2Factors-mcp-server%22%5D%2C%22env%22%3A%7B%22APIFY_TOKEN%22%3A%22%24%7Binput%3Aapify_token%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apify_token%22%2C%22description%22%3A%22Apify+API+Token%22%2C%22password%22%3Atrue%7D%5D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=actors-mcp-server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40apify%2Factors-mcp-server%22%5D%2C%22env%22%3A%7B%22APIFY_TOKEN%22%3A%22%24%7Binput%3Aapify_token%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apify_token%22%2C%22description%22%3A%22Apify+API+Token%22%2C%22password%22%3Atrue%7D%5D&quality=insiders)
+
+##### Manual installation
+
+You can manually install the Apify MCP Server in VS Code. First, click one of the install buttons at the top of this section for a one-click installation.
+
+Alternatively, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`.
+
+```json
+{
+  "mcp": {
+    "inputs": [
+      {
+        "type": "promptString",
+        "id": "apify_token",
+        "description": "Apify API Token",
+        "password": true
+      }
+    ],
+    "servers": {
+      "actors-mcp-server": {
+        "command": "npx",
+        "args": ["-y", "@apify/actors-mcp-server"],
+        "env": {
+          "APIFY_TOKEN": "${input:apify_token}"
+        }
+      }
+    }
+  }
+}
+```
+
+Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace - just omit the top-level `mcp {}` key. This will allow you to share the configuration with others.
+
+If you want to specify which Actors to load, you can add the `--actors` argument:
+
+```json
+{
+  "servers": {
+    "actors-mcp-server": {
+      "command": "npx",
+      "args": [
+        "-y", "@apify/actors-mcp-server",
+        "--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
+      ],
+      "env": {
+        "APIFY_TOKEN": "${input:apify_token}"
+      }
+    }
+  }
+}
+```
+
 #### Debugging NPM package @apify/actors-mcp-server with @modelcontextprotocol/inspector
 
 To debug the server, use the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) tool:
@@ -408,7 +464,7 @@ You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-
 
 ```bash
 export APIFY_TOKEN=your-apify-token
-npx @modelcontextprotocol/inspector node ./dist/index.js
+npx @modelcontextprotocol/inspector node ./dist/stdio.js
 ```
 
 Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

README.md

@@ -1,9 +1,9 @@
-import apify from '@apify/eslint-config';
+import apifyTypeScriptConfig from '@apify/eslint-config/ts.js';
 
 // eslint-disable-next-line import/no-default-export
 export default [
-    { ignores: ['**/dist', '**/.venv'] }, // Ignores need to happen first
-    ...apify,
+    { ignores: ['**/dist'] }, // Ignores need to happen first
+    ...apifyTypeScriptConfig,
     {
         languageOptions: {
             sourceType: 'module',