Skip to main content
Glama
Sign In
tc-ftp-mcp

tc-ftp-mcp

by bocimayer
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

tc-ftp-mcp

An MCP server that connects to FTP servers using the sessions you already saved in Total Commander. No second copy of your hosts and passwords: it reads wcx_ftp.ini directly.

What it does

Tools exposed to the MCP client:

Tool

Purpose

list_sessions

Saved sessions (name, host, port, user, start directory, passive, TLS). Never the password.

list_dir

List a remote directory.

read_text

Read a remote text file (capped at 256 KiB).

download_file

Download to a local path; refuses to overwrite.

upload_file

Upload a local file; refuses to replace unless overwrite=true.

make_dir, rename, delete_file

Basic remote changes.

Passwords are decoded in memory for the login and are never returned, logged or written to disk.

Related MCP server: File Server MCP

Install

git clone https://github.com/bocimayer/tc-ftp-mcp
cd tc-ftp-mcp
pip install -e .

Register it with Claude Code:

claude mcp add tc-ftp -- python -m tc_ftp_mcp

Or point at a different ini file:

claude mcp add tc-ftp -- python -m tc_ftp_mcp --ini "D:\path\to\wcx_ftp.ini"

The default ini location is %APPDATA%\GHISLER\wcx_ftp.ini.

Skill

skills/tc-ftp/SKILL.md teaches an agent the workflow: find candidate sessions, let you pick one, verify it read-only, and only then work, asking before any change. Install it by copying the folder to ~/.claude/skills/.

Limits

  • Plain FTP and explicit FTPS (sessions with ftps:// or ssl=1). SFTP sessions use a different Total Commander plugin and storage; not covered.

  • If you set a Total Commander master password, the stored passwords use a different scheme and will not decode.

  • Total Commander's stored form is obfuscation, not encryption (see CVE-2005-4066). Anyone who can read your wcx_ftp.ini can read your passwords. Treat the file, and this tool's access to it, accordingly.

  • Windows-1250 is assumed for the ini and for servers that do not support UTF-8.

Credits

The password scheme was reverse engineered by others; see PELock's write-up and the Apache-2.0 total-commander-ftp-password-recovery package. This repo contains an independent implementation of the same published steps.

Development

pip install -e .[dev] pyftpdlib
pytest

MIT licensed.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • fs-mcp

      quincydelp
      F
      license
      Not graded
      quality
      C
      maintenance
      Hosted filesystem MCP server over HTTP with auth. Enables reading, writing, editing, searching, and listing files via MCP tools like grep, glob, and tree.
      -

    • File Server MCP

      bill-gtl-group
      F
      license
      A
      quality
      D
      maintenance
      Enables accessing and managing files from configured folders with filtering and size limits, allowing listing, reading, and searching files via MCP tools and resources.
      3
      -

    • ftpmcp

      vielhuber
      A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for FTP and FTPS file operations, supporting multiple named hosts with configurable roots, read-only mode, and guarded deletion. It enables remote file management (list, upload, download, create, rename, delete) through natural language while keeping credentials secure.
      42 npm
      MIT

    • FTP MCP Server

      nao9net
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables managing files across multiple FTP servers through a single MCP interface, supporting upload, listing, deletion, and public URL generation.
      61 npm
      MIT