Mcp Sftp Orchestrator

io.github.fkom13由 GitHub 帳號 fkom13 發布v8.0.4更新於 Oct 24, 2026

Serveur MCP pour l'orchestration de tâches distantes (SSH/SFTP) avec une file d'attente persistante.

已驗證STDIO僅桌面雲端與基礎設施檔案與儲存安全與監控

概覽

AI 產生的概覽

一個本機 stdio MCP 伺服器，讓助理透過 SSH/SFTP 編排多台遠端伺服器，並具備持久工作佇列、檔案編輯、差異比對與快照功能。

可以做什麼
透過 SSH 在單一別名、多個別名、群組或全部伺服器上執行指令，支援持久佇列、重試與日誌，並可開啟互動式、序列化指令工作階段、遠端 tmux 工作階段與 SSH 通道。讀取、寫入並以雜湊校驗方式編輯本機與遠端檔案，透過 SFTP 傳輸檔案（含伺服器之間），比對檔案、目錄與專案來源。管理伺服器機群：別名與群組、SSH 公鑰授權、指令黑名單、API 目錄、伺服器備註、專案與工作工作階段。稽核與監控：基礎設施概覽與稽核、機群狀態、清冊、CPU/記憶體/磁碟、systemd/Docker/PM2 服務、Fail2Ban、API 健康檢查與日誌。建立、列出、比對、還原與刪除基礎設施快照。
適用情境
適合需要助理在同一處操作多台遠端 Linux 伺服器的情境：部署或修復檔案、在機群中批次執行指令、比對本機與遠端專案目錄，或記錄介入備註與快照。適合已透過 SSH 管理伺服器、希望代理沿用相同存取方式的維運人員。
執行需求
以 Node.js 本機程序執行（Node.js 18 或更新版本），透過 stdio 由 MCP 用戶端以伺服器腳本路徑啟動。需要目標主機的 SSH 存取權限，透過保存金鑰路徑或密碼的伺服器別名設定。選用環境變數可設定資料目錄、逾時、連線池、允許的本機根目錄、唯讀模式與除錯日誌。
安裝前請注意
它授予廣泛的遠端控制能力：透過 SSH 執行指令、寫入與編輯檔案、將金鑰加入 authorized_keys、開啟通道，因此一次誤操作就可能變更或刪除正式主機上的資料。伺服器別名可在本機 JSON 檔案中保存 SSH 密碼，API 目錄也保存密鑰，儘管工具讀取時會遮蔽。破壞性指令預設為試執行，並有黑名單與唯讀模式，但 skip_policy 與 force 可繞過。優先使用金鑰路徑而非明文密碼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Sftp Orchestrator，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

🚀 MCP Orchestrator — Serveur d'orchestration SSH/SFTP

v11.8.0 Security Refresh — Les 82 tools publient désormais les annotations MCP standard. infra_overview reste léger sans argument, mais infra_overview { alias: "..." } effectue une découverte live et corrèle Nginx/domaines, ports, Docker/Compose et services. Voir CHANGELOG.md.

Version : 11.8.0
Tools : 82
License : MIT
Node : >= 18.0.0
Changelog : CHANGELOG.md

Serveur MCP (Model Context Protocol, transport stdio) qui donne à un agent IA la capacité d’orchestrer un parc de serveurs : SSH, SFTP, édition de fichiers locale/remote (hash-safe), diffs cross-server, shell PTY, snapshots d’infra, notes de protocole, projets, sessions de travail, inventaire, trust SSH (pubkey), groupes d’alias et audit parc.

✨ Points forts (v11.6)

DomaineCapacité
Exécutiontask_exec multi-serveur / group:oci / dry-run destructif / force
Fichiersfile_read / file_edit (chirurgical) / file_write + hash + dryRun + backup
Parcnotes, infra_audit, fleet_status, server_inventory
Projetsregistre local↔remote + project_diff
Travailwork_start → edits → work_end (note d’intervention auto)
Trustssh_authorize_key (pubkey only, dry_run par défaut)
Sécusecrets masqués, RO global + RO par alias, blocklist, pool SSH robuste

📦 Installation

bash
git clone https://github.com/fkom13/mcp-sftp-orchestrator.gitcd sftp-mcp   # ou tools/sftp-mcpnpm installcp .env.example .env# Éditer MCP_DATA_DIR et chemins de clés

Prérequis : Node.js >= 18

⚙️ Configuration (.env)

Toutes les variables sont optionnelles.

VariableDéfautDescription
MCP_DATA_DIR~/.config/mcp-orchestratorDossier data (JSON, snapshots, projets…)
MCP_SYNC_TIMEOUT_S120Délai (s) avant passage d’une tâche en arrière-plan
MCP_DEFAULT_CMD_TIMEOUT_S600Timeout SSH commande (s). 0 = infini
MCP_INTERACTIVE_CMD_TIMEOUT_S300Timeout interactif (s). 0 = infini
MCP_MAX_WAIT_TIMEOUT_S600Timeout max task_wait (s)
MAX_CONNECTIONS_PER_SERVER5Pool SSH max / serveur
MIN_CONNECTIONS_PER_SERVER1Pool SSH min / serveur
IDLE_TIMEOUT300000Fermeture connexion inactive (ms)
KEEP_ALIVE_INTERVAL30000Keepalive SSH (ms)
MAX_QUEUE_SIZE1000Taille max queue jobs
SAVE_INTERVAL5000Autosave queue (ms)
MCP_ALLOWED_ROOTS(vide)Racines autorisées pour paths locaux (CSV)
MCP_READONLYfalse1 = refuse écritures / exec mutantes (global)
MCP_COMPACTfalse1 = réponses tronquées (tokens agent)
MCP_DEBUGfalseLogs détaillés stderr

Fichiers sous MCP_DATA_DIR

FichierContenu
servers.jsonAlias SSH (host, user, keyPath/password, port?, readonly?)
apis.jsonCatalogue APIs (secrets masqués en lecture tools)
queue.json / queue.backup.jsonJobs
history.jsonHistorique tâches
server_notes.jsonProtocoles / notes par serveur
server_groups.jsonGroupes d’alias
projects.jsonRegistre projets
work_sessions.jsonSessions de travail
policies.jsonBlocklist commandes
tunnels.json / tunnel_allowlist.jsonTunnels SSH
infra_snapshots/Snapshots content-addressable

🔌 Connexion client MCP

Grok / config.toml

toml
[mcp_servers.orchestrator]command = "node"args = ["/chemin/absolu/sftp-mcp/server.js"]# optionnel:# env = { MCP_DATA_DIR = "/chemin/absolu/sftp-mcp/data" }

OpenCode / Claude Desktop (JSON)

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

Après modification du code : recharger le serveur MCP (/mcps → r ou restart session). Vérifier system_diagnostics → version: "11.8.0".

🧰 Référence des outils (82)

Diagnostic & audit

OutilDescription
helpGuide outils + .env + astuces
guideManuel IA (workflows, cheatsheet, pitfalls, audit, security)
system_diagnosticsQueue, pool, serveurs/APIs masqués, version, readOnly
infra_auditSynthèse parc + projets + notes + crashed
infra_overviewServeurs + notes (vue légère)
fleet_statusPing SSH parallèle (latence, load, disk)
server_inventoryInventaire léger (pm2/docker/disk/home, cache 10 min)

Serveurs & groupes

OutilDescription
server_addCRUD alias (keyPath ou password, port, readonly)
server_listListe (passwords masqués)
server_removeSupprime un alias
server_group_list/set/removeGroupes (oci, contabo…). Usage : group:oci ou nom de groupe

Projets (v11.6)

OutilDescription
project_list / project_get / project_set / project_removeRegistre
project_resolve→ { local, remote, ignore, runtime }
project_diffDiff local↔remote du projet

Exemple project_set :

json
{  "name": "p-image",  "local": { "path": "/home/.../dev-serveur/p-image" },  "servers": {    "prod": {      "alias": "fkomprodmini2_prod",      "path": "/home/ubuntu/p-image",      "runtime": { "pm2": "p-image", "port": 5002 },      "url": "https://pruna.esprit-artificiel.com"    }  },  "ignore": ["node_modules", ".git", "data"]}

Sessions de travail (v11.6)

OutilDescription
work_startOuvre un journal (alias, project, tag, snapshot optionnel)
work_logEvent (file_edit, task_exec, …)
work_listSessions actives (+ historique)
work_endClôture + server_note last_intervention

Trust SSH (v11.6)

OutilDescription
ssh_authorize_keyAjoute une pubkey dans authorized_keys distant. dry_run défaut. Sources : string | local_path | alias
json
{  "target_alias": "fkomprodmini1_prod",  "source": { "type": "alias", "alias": "vps_contabo" },  "comment": "fleet-from-contabo",  "dry_run": true}

Policies

OutilDescription
policy_blocklist_list/add/removeBlocklist commandes (aussi appliquée à shell + sequences)

Catalogue API

OutilDescription
api_add / api_list / api_remove / api_checkMonitoring (clés masquées en list)

Exécution de tâches

OutilDescription
task_execSSH ; alias | tableau | all | group:x ; dry_run/force destructif
task_exec_interactivePrompts yes/no, menus
task_exec_sequenceSéquence sur un serveur (policy par étape)
task_transferSFTP upload/download/server_to_server
task_transfer_multiMulti + globs

Files / Diff / Shell / Snapshots

FamilleOutils
Filesfile_read, file_write, file_edit
Diffdiff_files, diff_folders, compare_all_sources
Shellshell_create, shell_exec (+ skip_policy), shell_list, shell_close
Snapshotssnapshot_create/list/diff/restore/delete

Édition safe : file_read → hash → file_edit + expectedHash (+ dryRun / backup).

Notes serveur

OutilDescription
server_note_set/get/list/removeProtocole (description, services, warnings, intervention)

Monitoring & logs

OutilDescription
get_system_resourcesCPU / RAM / disque
get_services_statussystemd / Docker / PM2
get_fail2ban_statusFail2Ban
check_api_healthHTTP via SSH+curl
get_pm2_logs / get_docker_logs / tail_fileLogs

Queue

OutilDescription
task_queue / task_status / task_history / task_wait / task_logsSuivi
task_retry / task_retry_allRelance
task_purgePurge (dry_run défaut)
queue_stats / pool_statsStats

Tmux & tunnels

OutilDescription
tmux_create/exec/read/list/killSessions tmux distantes
tunnel_create/list/closeTunnels SSH local/remote/socks
tunnel_allowlist_add/removePorts autorisés pour tunnels

📖 Workflows agent recommandés

Début de session

infra_audit  (ou infra_overview)fleet_statusproject_list / project_resolve

Chantier sur un projet

work_start { project: "p-image", alias: "fkomprodmini2_prod", tag: "fix-x", message: "…" }file_read → file_edit (expectedHash, dryRun puis apply)work_log { type: "file_edit", path: "…" }work_end { summary: "…" }   → note serveur mise à jourproject_diff { name: "p-image" }

Commandes longues

task_exec { timeout: 0, … }  → si > syncTimeout → task_wait { id }

Cibles multi-serveurs

task_exec { alias: "group:oci", cmd: "hostname" }task_exec { alias: "all", cmd: "uptime" }

🏗️ Architecture

Client MCP (stdio)    │server.js ─── 82 tools    │    ├── queue.js          File d’attente persistante + purge/retry    ├── ssh.js / sshPool  Exécution + pool (retry safe, port configurable)    ├── sftp.js           Transferts (server_to_server via sourceAdapter/pool)    ├── sourceAdapter.js  Local fs | remote SFTP pool    ├── fileOps.js        Read/write/edit + hash + dryRun + backup    ├── diffEngine.js / compareEngine.js / diffFormatter.js    ├── shellSessions.js  PTY persistants + policy    ├── snapshotManager.js    ├── projects.js / workSession.js / inventory.js / groups.js / fleet.js    ├── sshTrust.js       authorized_keys (pubkey only)    ├── servers.js / apis.js / notes.js / policies.js / tunnels.js    ├── history.js / guide.js / config.js / utils.js

Cycle de vie d’un job

pending → running → completed | failed | partial                      ↓ (redémarrage MCP pendant running)                    crashed → task_retry → pending

🔒 Sécurité

MécanismeDétail
SecretsMasqués en api_list / diagnostics (*** + 4 derniers car.)
Shell escapeescapeShellArg sur curl, logs, chemins
Blocklistpolicies.json ; shell + sequence inclus ; skip_policy pour forcer
RO globalMCP_READONLY=1
RO alias"readonly": true dans servers.json
Destructiftask_exec dry-run si pattern dangereux sans force:true
TrustPubkey only ; dry_run par défaut
ClésPréférer keyPath SSH ; Vaultwarden pour secrets API

🧪 Tests

bash
npm test:unit    # p0 + p1 + p16 (43 tests)npm test         # unit + smoke MCP + featuresnode diagnose.js # diagnostic local optionnel
FichierCouverture
test_p0_unit.jsutils, policies, redact, timeouts, version
test_p1_unit.jsgroups, purge, destructive, RO env
test_p16_unit.jsprojects, work session, compact, sshTrust
test_mcp.jssmoke SDK
test_features.jsqueue / pool / globs / prompts

🛣️ Versions récentes

VersionContenuSnapshot gencodedoc
11.6.1Hardening multi-agent: RO transversal, server-to-server dossiers/force, allowed roots anti-symlink, quoting shell/tmux, queue + JSON stores atomiques—
11.6.0Projets, work sessions, inventory, ssh_authorize_key, RO alias, compact#23 (final docs)
11.4.0fleet, infra_audit, groups, retry_all, purge, pool rewrite#21
11.3.0Secrets mask, policy shell/seq, port SSH, wait partial#20
10.4–10.0file ops, diff, shell, snapshots, notes, guide#17–19
9.x / 8.xSFTP force, timeouts, interactif, sécu de base—

Détail : CHANGELOG.md · plans historiques : ROADMAP.md, ROADMAP_EXTENDED.md.

📄 Licence

MIT — Copyright (c) 2025-2026 Franck (fkom13)

來源：README.md，提交 91725bf

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v8.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。