FTP 访问的 MCP 服务器

此模型上下文协议（MCP）服务器提供了与 FTP 服务器交互的工具。它允许 Claude.app 列出目录、下载和上传文件、创建目录以及删除文件/目录。

功能

• 列出目录内容：查看 FTP 服务器上的文件和文件夹
• 下载文件：从 FTP 服务器获取文件内容
• 上传文件：创建新文件或更新现有文件
• 创建目录：在 FTP 服务器上创建新文件夹
• 删除文件/目录：移除文件或目录

安装

通过 Smithery 安装

要通过 Smithery 自动安装 mcp-server-ftp：

npx -y @smithery/cli install @alxspiker/mcp-server-ftp --client claude

先决条件

• Node.js 16 或更高版本
• Claude 桌面版（或其他兼容 MCP 的客户端）

从源代码构建

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

# 运行 Windows 构建辅助脚本
build-windows.bat

build-windows.bat 脚本处理 Windows 系统上的依赖安装和构建，并提供如果 TypeScript 编译器出现问题时的回退选项。

配置

要使用此服务器与 Claude 桌面版，请将其添加到您的配置文件中：

MacOS/Linux

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "ftp-server": {
      "command": "node",
      "args": ["/绝对路径/to/mcp-server-ftp/build/index.js"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_PORT": "21",
        "FTP_USER": "你的用户名",
        "FTP_PASSWORD": "你的密码",
        "FTP_SECURE": "false"
      }
    }
  }
}

Windows

编辑 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "ftp-server": {
      "command": "node",
      "args": ["C:\\路径\\to\\mcp-server-ftp\\build\\index.js"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_PORT": "21",
        "FTP_USER": "你的用户名",
        "FTP_PASSWORD": "你的密码",
        "FTP_SECURE": "false"
      }
    }
  }
}

解决 Windows 构建问题

如果您在 Windows 上遇到构建问题：

1. 使用提供的 build-windows.bat 脚本，该脚本处理常见的构建问题
2. 确保 Node.js 和 npm 已正确安装
3. 尝试直接运行 TypeScript 编译器：npx tsc
4. 如果您仍然遇到问题，可以使用 build 目录中的预编译文件，运行：

   node 路径\to\mcp-server-ftp\build\index.js
   

配置选项

环境变量	描述	默认值
FTP_HOST	FTP 服务器主机名或 IP 地址	localhost
FTP_PORT	FTP 服务器端口	21
FTP_USER	FTP 用户名	anonymous
FTP_PASSWORD	FTP 密码	（空字符串）
FTP_SECURE	使用安全 FTP（FTPS）	false

使用方法

配置并重启 Claude 桌面版后，您可以使用自然语言执行 FTP 操作：

• “列出我的 FTP 服务器 /public 目录中的文件”
• “从 FTP 服务器下载 /data/report.txt 文件”
• “将此文本作为名为 notes.txt 的文件上传到 FTP 服务器”
• “在 FTP 服务器上创建一个名为 'backups' 的新目录”
• “从 FTP 服务器删除 obsolete.txt 文件”
• “从 FTP 服务器删除空目录 /old-project”

可用工具

工具名称	描述
list-directory	列出 FTP 目录的内容
download-file	从 FTP 服务器下载文件
upload-file	向 FTP 服务器上传文件
create-directory	在 FTP 服务器上创建新目录
delete-file	从 FTP 服务器删除文件
delete-directory	从 FTP 服务器删除目录

安全注意事项

• FTP 凭证存储在 Claude 配置文件中。确保此文件具有适当的权限。
• 如果您的服务器支持，考虑通过设置 FTP_SECURE=true 使用 FTPS（安全 FTP）。
• 服务器会在系统临时目录中为上传和下载创建临时文件。

许可证

MIT