MCP Server for FTP Access
2025.03.31
3
JavaScriptFTP 服务文件传输文件管理
mcp-server-ftp 是一个基于 Model Context Protocol (MCP) 的服务器，专门用于与 FTP 服务器进行交互。它允许用户通过 Claude.app 或其他 MCP 兼容客户端执行 FTP 操作，包括列出目录内容、下载和上传文件、创建目录以及删除文件或目录。
View on GitHub
Overview
基本能力
产品定位
mcp-server-ftp 是一个 FTP 服务器交互工具，旨在通过 MCP 协议提供对 FTP 服务器的便捷访问和管理功能。
核心功能
- 列出目录内容：查看 FTP 服务器上的文件和文件夹
- 下载文件：从 FTP 服务器检索文件内容
- 上传文件：创建新文件或更新现有文件
- 创建目录：在 FTP 服务器上创建新文件夹
- 删除文件/目录：移除文件或目录
适用场景
- 需要通过自然语言命令管理 FTP 服务器的场景
- 自动化 FTP 文件传输和管理的任务
- 集成 FTP 功能到 MCP 兼容客户端中
工具列表
| 工具名称 | 描述 |
|---|---|
list-directory |
列出 FTP 目录内容 |
download-file |
从 FTP 服务器下载文件 |
upload-file |
上传文件到 FTP 服务器 |
create-directory |
在 FTP 服务器上创建新目录 |
delete-file |
从 FTP 服务器删除文件 |
delete-directory |
从 FTP 服务器删除目录 |
常见问题解答
- Windows 构建问题：
- 使用提供的
build-windows.bat脚本处理常见构建问题 - 确保 Node.js 和 npm 已正确安装
- 尝试直接运行 TypeScript 编译器：
npx tsc - 如果仍有问题，可以使用
build目录中的预编译文件
使用教程
使用依赖
- Node.js 16 或更高版本
- Claude for Desktop（或其他 MCP 兼容客户端）
安装教程
通过 Smithery 安装
npx -y @smithery/cli install @alxspiker/mcp-server-ftp --client claude
从源代码构建
Linux/macOS
git clone https://github.com/alxspiker/mcp-server-ftp.git
cd mcp-server-ftp
npm install
npm run build
Windows
git clone https://github.com/alxspiker/mcp-server-ftp.git
cd mcp-server-ftp
build-windows.bat
调试方式
- 确保配置文件正确设置 FTP 连接参数
- 检查 Node.js 和 npm 版本是否符合要求
- 查看构建过程中是否有错误信息
- 尝试直接运行构建后的文件：
node path/to/mcp-server-ftp/build/index.js