MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
SFTP-only file access for AI: browse, edit, transfer and sync files, no shell access needed.
Texto original del autor
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala SFTP. Sigue https://mcp.popnx.com/i/adverstm-sftp-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de SFTP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server SFTP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "sftp": { "command": "npx", "args": [ "-y", "sftp-mcp" ], "env": { "SFTP_PASSWORD": "your-value", "SFTP_PRIVATE_KEY": "your-value", "SFTP_PASSPHRASE": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de SFTP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
SettingsDeveloperEdit Config
{
"mcpServers": {
"sftp": {
"command": "npx",
"args": [
"-y",
"sftp-mcp"
],
"env": {
"SFTP_PASSWORD": "your-value",
"SFTP_PRIVATE_KEY": "your-value",
"SFTP_PASSPHRASE": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa SFTP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando SFTP o muestra una herramienta de SFTP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SFTP_HOST Host SSH (modo de servidor único). SFTP_PORT Puerto SSH. SFTP_USER Nombre de usuario SSH (modo de servidor único). SFTP_SERVERS_FILE Ruta a un mapa JSON de id de servidor a conexión, para varios servidores. Reemplaza las variables de un solo servidor. SFTP_READ_ONLY Deniega todas las mutaciones remotas. SFTP_ALLOW_DESTRUCTIVE Establezca en false para denegar delete, rmdir, rename y sync sin dry-run. SFTP_ALLOWED_WRITE_PREFIX Prefijo de ruta remota absoluta al que se limitan las modificaciones. SFTP_ALLOWED_READ_PREFIX Prefijo de ruta remota absoluta al que se limitan las lecturas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar SFTP
SFTP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar SFTP
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de SFTP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server SFTP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user sftp --env SFTP_PASSWORD=your-value --env SFTP_PRIVATE_KEY=your-value --env SFTP_PASSPHRASE=your-value -- npx -y sftp-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de SFTP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user sftp --env SFTP_PASSWORD=your-value --env SFTP_PRIVATE_KEY=your-value --env SFTP_PASSPHRASE=your-value -- npx -y sftp-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver SFTP en la lista como conectado
Usa SFTP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando SFTP o muestra una herramienta de SFTP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SFTP_HOST Host SSH (modo de servidor único). SFTP_PORT Puerto SSH. SFTP_USER Nombre de usuario SSH (modo de servidor único). SFTP_SERVERS_FILE Ruta a un mapa JSON de id de servidor a conexión, para varios servidores. Reemplaza las variables de un solo servidor. SFTP_READ_ONLY Deniega todas las mutaciones remotas. SFTP_ALLOW_DESTRUCTIVE Establezca en false para denegar delete, rmdir, rename y sync sin dry-run. SFTP_ALLOWED_WRITE_PREFIX Prefijo de ruta remota absoluta al que se limitan las modificaciones. SFTP_ALLOWED_READ_PREFIX Prefijo de ruta remota absoluta al que se limitan las lecturas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de SFTP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server SFTP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "sftp": { "command": "npx", "args": [ "-y", "sftp-mcp" ], "env": { "SFTP_PASSWORD": "your-value", "SFTP_PRIVATE_KEY": "your-value", "SFTP_PASSPHRASE": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de SFTP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de SFTP, SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa SFTP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando SFTP o muestra una herramienta de SFTP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SFTP_HOST Host SSH (modo de servidor único). SFTP_PORT Puerto SSH. SFTP_USER Nombre de usuario SSH (modo de servidor único). SFTP_SERVERS_FILE Ruta a un mapa JSON de id de servidor a conexión, para varios servidores. Reemplaza las variables de un solo servidor. SFTP_READ_ONLY Deniega todas las mutaciones remotas. SFTP_ALLOW_DESTRUCTIVE Establezca en false para denegar delete, rmdir, rename y sync sin dry-run. SFTP_ALLOWED_WRITE_PREFIX Prefijo de ruta remota absoluta al que se limitan las modificaciones. SFTP_ALLOWED_READ_PREFIX Prefijo de ruta remota absoluta al que se limitan las lecturas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de SFTP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server SFTP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "sftp": { "type": "stdio", "command": "npx", "args": [ "-y", "sftp-mcp" ], "env": { "SFTP_PASSWORD": "your-value", "SFTP_PRIVATE_KEY": "your-value", "SFTP_PASSPHRASE": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de SFTP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de SFTP, SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa SFTP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando SFTP o muestra una herramienta de SFTP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SFTP_HOST Host SSH (modo de servidor único). SFTP_PORT Puerto SSH. SFTP_USER Nombre de usuario SSH (modo de servidor único). SFTP_SERVERS_FILE Ruta a un mapa JSON de id de servidor a conexión, para varios servidores. Reemplaza las variables de un solo servidor. SFTP_READ_ONLY Deniega todas las mutaciones remotas. SFTP_ALLOW_DESTRUCTIVE Establezca en false para denegar delete, rmdir, rename y sync sin dry-run. SFTP_ALLOWED_WRITE_PREFIX Prefijo de ruta remota absoluta al que se limitan las modificaciones. SFTP_ALLOWED_READ_PREFIX Prefijo de ruta remota absoluta al que se limitan las lecturas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user sftp --env SFTP_PASSWORD=your-value --env SFTP_PRIVATE_KEY=your-value --env SFTP_PASSPHRASE=your-value -- npx -y sftp-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"sftp": {
"command": "npx",
"args": [
"-y",
"sftp-mcp"
],
"env": {
"SFTP_PASSWORD": "your-value",
"SFTP_PRIVATE_KEY": "your-value",
"SFTP_PASSPHRASE": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"sftp": {
"command": "npx",
"args": [
"-y",
"sftp-mcp"
],
"env": {
"SFTP_PASSWORD": "your-value",
"SFTP_PRIVATE_KEY": "your-value",
"SFTP_PASSPHRASE": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"sftp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sftp-mcp"
],
"env": {
"SFTP_PASSWORD": "your-value",
"SFTP_PRIVATE_KEY": "your-value",
"SFTP_PASSPHRASE": "your-value"
}
}
}
}SFTP_HOST envSFTP_PORT envSFTP_USER envSFTP_PASSWORD secreto obligatorio envSFTP_PRIVATE_KEY secreto obligatorio envSFTP_PASSPHRASE secreto obligatorio envSFTP_SERVERS_FILE envSFTP_READ_ONLY envSFTP_ALLOW_DESTRUCTIVE envSFTP_ALLOWED_WRITE_PREFIX envSFTP_ALLOWED_READ_PREFIX envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: sftp-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub AdversTM, dueña del repo
Último cambio de código: hace 8 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para sftp-mcp@1.1.4
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/adverstm-sftp-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: SFTP_PASSWORD, SFTP_PRIVATE_KEY, SFTP_PASSPHRASE
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 8 días, y la última versión (1.1.4) llegó al registro hace 8 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este SFTP | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | Sí | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
SFTP for AI assistants. Files only, no shell.
A Model Context Protocol server that lets Claude and other MCP clients browse, edit, transfer and sync files over plain SFTP. It works on chrooted, SFTP-only and shared-hosting accounts where SSH-based servers can't run, and the assistant never gets a shell.
Install · Configure · Tools · Security · Contribute
Most MCP servers for remote machines are SSH servers that can also move files. They need a shell account and give the assistant command execution. sftp-mcp does the opposite: it only speaks the SFTP protocol.
| sftp-mcp | Typical SSH MCP server | |
|---|---|---|
| Works with SFTP-only and chrooted accounts | Yes | Usually needs a shell |
| Assistant can run arbitrary commands | No | Yes |
| Read-only, no-delete and path limits per server | Built in | Varies |
| Many hosts from one process | Yes | Varies |
| Parallel transfers over one warm connection per host | Yes | Varies |
| Directory sync that uploads only changed files | Yes | Varies |
The only remote command it ever sends is a fixed sha256sum for hashing. If the account has no shell, it hashes over SFTP instead.
Pick sftp-mcp when the assistant should work with files: deploying a site, editing configs, pulling logs or syncing a build. Pick an SSH server when it needs to run commands.
Requires Node.js 24 or newer. Most MCP clients can start the server straight from npm, with nothing to install:
npx -y sftp-mcp
Or install it globally and use the sftp-mcp command:
npm install -g sftp-mcp
Add the server to your MCP client. For Claude Desktop, edit claude_desktop_config.json:
{
"mcpServers": { "sftp": { "command": "npx", "args": ["-y", "sftp-mcp"], "env": { "SFTP_HOST": "sftp.example.com", "SFTP_USER": "deploy", "SFTP_PRIVATE_KEY": "/home/me/.ssh/id_ed25519" } } } }
On Windows, npx may need to go through cmd: "command": "cmd", "args": ["/c", "npx", "-y", "sftp-mcp"].
For Claude Code:
claude mcp add sftp -e SFTP_HOST=sftp.example.com -e SFTP_USER=deploy \
-e SFTP_PRIVATE_KEY=$HOME/.ssh/id_ed25519 -- npx -y sftp-mcp
Restart the client and ask it something like _"list /var/www on the sftp server"_.
All configuration comes from environment variables. Invalid values stop the server at startup with a clear error, so a typo never quietly loosens a policy.
| Variable | Default | Description |
|---|---|---|
SFTP_HOST | required | SSH host |
SFTP_PORT | 22 | SSH port |
SFTP_USER | required | SSH username |
SFTP_PASSWORD | Password authentication | |
SFTP_PRIVATE_KEY | Path to a private key file | |
SFTP_PASSPHRASE | Passphrase for the private key |
The server is registered with the id default.
Describe the servers as a JSON map of id to connection. Pass it inline in SFTP_SERVERS, or as a file path in SFTP_SERVERS_FILE. You can't set both.
{
"prod": { "host": "prod.example.com", "username": "deploy", "privateKey": "/home/me/.ssh/id_ed25519", "allowedWritePrefix": "/var/www", "allowDestructive": false, "description": "Production web" }, "staging": { "host": "staging.example.com", "port": 2222, "username": "ci", "password": "secret" } }
| Field | Description |
|---|---|
host, username (alias user) | Required |
port | Defaults to 22 |
password, privateKey, passphrase | Credentials. privateKey is a local file path |
readOnly, allowDestructive, readyTimeout | Per-server overrides of the global settings below |
allowedReadPrefix, allowedWritePrefix | Path restrictions, see Access control |
description | Shown to the assistant in sftp_list_servers |
Ids must match A-Za-z0-9*. Unknown fields stop startup. The single-server variables can't be combined with a server map.
| Variable | Default | Description |
|---|---|---|
SFTP_READ_ONLY | false | Deny every remote mutation |
SFTP_ALLOW_DESTRUCTIVE | true | false denies delete, rmdir, rename and non-dry-run sync |
SFTP_ALLOWED_WRITE_PREFIX | Absolute path prefix for mutations (single-server mode) | |
SFTP_ALLOWED_READ_PREFIX | Absolute path prefix for reads (single-server mode) | |
SFTP_DISABLED_TOOLS | Comma-separated tool names to hide from the client | |
SFTP_READY_TIMEOUT | 20000 | SSH handshake timeout, in ms |
SFTP_MAX_READ_BYTES | 1048576 | Size limit for sftp_read. Larger files must use sftp_download |
SFTP_MAX_CONCURRENCY | 8 | Default parallelism of the batch tools |
SFTP_TRANSFER_CONCURRENCY | 64 | In-flight requests per file transfer |
SFTP_CHUNK_SIZE | 32768 | Transfer chunk size in bytes (minimum 1024) |
SFTP_LOG_FILE | Also append logs to this file, for clients that hide stderr. Its directory must exist |
Booleans must be exactly true or false.
Policies apply to each server separately and are checked before any SFTP request is sent.
| Policy | Effect |
|---|---|
readOnly: true | Blocks every mutation, including dry-run sync. Overrides everything else. |
allowDestructive: false | Writes, uploads and mkdir still work. Delete, rmdir, rename/move and non-dry-run sync are blocked. |
allowedWritePrefix | Mutations only inside this path. Both ends of a rename are checked. |
allowedReadPrefix | Listing, reading, downloads, stat and hashing only inside this path. |
Prefixes are normalized and compared as POSIX paths: /srv/app allows /srv/app and /srv/app/x, but not /srv/app-old. A prefix of / allows everything.
[!IMPORTANT]
Prefix checks are lexical. A symlink on the server can still point outside the allowed prefix.
For hard isolation, use a chroot, account permissions, or SFTP server configuration.
To hide tools from the assistant entirely, set SFTP_DISABLED_TOOLS, for example sftp_delete,sftp_sync_dir. Hidden tools are never registered, so they never appear in the client's tool list.
Every tool except sftp_list_servers takes a server argument (one of the configured ids).
| Tool | Kind | Description |
|---|---|---|
sftp_list_servers | discovery | Configured servers with their address, policy and description |
sftp_list | read | List a directory (type, size, mtime, name) |
sftp_read | read | Read a text file, up to SFTP_MAX_READ_BYTES |
sftp_stat | read | File metadata |
sftp_exists | read | false, or the entry type: d, - or l |
sftp_sha256 | read | SHA-256 via sha256sum on the server, falling back to SFTP streaming |
sftp_download | read | Download a remote file to a local path |
sftp_download_many | read | Parallel downloads |
sftp_write | write | Create or overwrite a text file from inline content |
sftp_upload | write | Upload a local file (binary-safe, parallel chunks) |
sftp_mkdir | write | Create a directory, optionally recursive |
sftp_write_many | write | Parallel text writes |
sftp_upload_many | write | Parallel uploads |
sftp_sync_dir | write | Upload missing, changed or newer files. Can also delete remote files missing locally. Supports dryRun |
sftp_delete | destructive | Delete a file |
sftp_rmdir | destructive | Remove a directory, optionally recursive |
sftp_rename | destructive | Rename or move |
sftp_delete_many | destructive | Parallel deletes |
Batch tools report each failure individually, so one bad file doesn't abort the batch.
Requires Bun 1.4+ for tooling. The published pa