MCP Orchestrator

You use the MCP Orchestrator to remotely orchestrate tasks over SSH and SFTP, with a persistent task queue, multi-server management, and an interface suitable for large-language-model tooling. This server lets you configure multiple targets, run commands (including interactive prompts), transfer files, monitor resources and services, and manage task histories and retries from a single, centralized control plane.

How to use

You connect to the Orchestrator through an MCP client and use its tools to manage servers, run commands, perform file transfers, and monitor health. Start by configuring one or more servers, then issue tasks such as executing commands, transferring files with optional glob patterns, or launching sequences of actions on a chosen host. Use the queue to review ongoing tasks, retry failed ones, and inspect histories. You can also add and check APIs for external monitoring and health checks, all from a single API surface.

How to install

Prerequisites you need before installation are Node.js and npm. The server is designed to be run in a Node.js environment, either as a local development instance or deployed in your infrastructure.

Option 1: Install via npm/via npx (recommended) You don’t need to clone the repository. You will register the MCP with your client and run the orchestrator on demand.

Register the MCP server under your client configuration. Use the following MCP server entry to run the orchestrator with npx.

{
  "mcpServers": {
    "orchestrator": {
      "command": "npx",
      "args": [
        "@fkom13/mcp-sftp-orchestrator"
      ],
      "env": {
        "MCP_DATA_DIR": "/chemin/absolu/vers/votre/dossier/de/donnees"
      }
    }
  }
}

How to install

Option 2: Install from sources (clone and run locally) This option is useful if you want to modify the code.

Clone the repository and install dependencies.

git clone https://github.com/fkom13/mcp-sftp-orchestrator.git
cd mcp-sftp-orchestrator
npm install

Configure your client to start the server locally using Node.js and the local server script.

{
  "mcpServers": {
    "orchestrator": {
      "command": "node",
      "args": [
        "/chemin/vers/mcp-sftp-orchestrator/server.js"
      ],
      "env": {
        "MCP_DATA_DIR": "/chemin/vers/mcp-sftp-orchestrator/data"
      }
    }
  }
}

Available tools

server_add

Register or update connection information for a server.

server_list

Show the list of all configured server aliases.

server_remove

Remove a server alias from configuration.

task_exec

Execute an SSH command (synchronous/asynchronous hybrid).

task_transfer

Transfer a file or folder via SFTP (hybrid sync/async).

task_exec_interactive

Run an interactive SSH command that handles prompts.

task_exec_sequence

Run multiple SSH commands in sequence on the same server.

task_transfer_multi

Transfer multiple files/folders with glob support.

get_system_resources

Retrieve system resource metrics (CPU, RAM, disk).

get_services_status

Query service statuses (systemd, Docker, PM2).

get_fail2ban_status

Retrieve information about Fail2Ban.

get_pm2_logs

Fetch PM2 application logs.

get_docker_logs

Fetch logs from a Docker container.

tail_file

Tail the last lines of a remote file.

task_queue

Show the status of all tasks in the queue.

task_status

Get details of a task by ID.

task_history

Display history of recently launched tasks.

task_retry

Retry a failed or crashed task.

queue_stats

Display queue statistics.

api_add

Add an API to the monitoring catalog.

api_list

List all configured APIs.

api_remove

Remove an API from the catalog.

api_check

Run a health check on an API.

task_logs

Show logs of the MCP system.

pool_stats

Show SSH connection pool statistics.