MCP 服务器用于 FTP 访问

这个模型上下文协议 (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

# Clone the repository
git clone https://github.com/alxspiker/mcp-server-ftp.git
cd mcp-server-ftp

# Install dependencies
npm install

# Build the project
npm run build

Windows

# Clone the repository
git clone https://github.com/alxspiker/mcp-server-ftp.git
cd mcp-server-ftp

# Run the Windows build helper script
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
   

配置选项

使用方法

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

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

可用工具

安全考虑

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

许可证

MIT