用于 FTP 访问的 MCP 服务器

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

功能

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

安装

通过 Smithery 安装

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

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

前提条件

• Node.js 16 或更高版本
• Claude for Desktop（或其他 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 for Desktop 一起使用，请将其添加到您的配置文件：

MacOS/Linux

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

{
  "mcpServers": {
    "ftp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-ftp/build/index.js"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_PORT": "21",
        "FTP_USER": "your-username",
        "FTP_PASSWORD": "your-password",
        "FTP_SECURE": "false"
      }
    }
  }
}

Windows

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

{
  "mcpServers": {
    "ftp-server": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-server-ftp\\build\\index.js"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_PORT": "21",
        "FTP_USER": "your-username",
        "FTP_PASSWORD": "your-password",
        "FTP_SECURE": "false"
      }
    }
  }
}

解决 Windows 构建问题

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

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

   node path\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 for Desktop 后，您可以使用自然语言来执行 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