Back to MCP directory
publicPublicdnsLocal runtime

alxspiker_mcp-server-ftp

这是一个提供FTP服务器交互功能的MCP服务,支持目录查看、文件上传下载、创建删除目录等操作,可与Claude桌面应用集成使用。

article

README

🚀 MCP 服务器用于 FTP 访问

此模型上下文协议 (MCP) 服务器为与 FTP 服务器交互提供了工具。它让 Claude.app 能够在 FTP 服务器上列出目录、下载和上传文件、创建目录以及删除文件或目录,为用户操作 FTP 服务器提供了便利。

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 mcp - server - ftp 用于 Claude 桌面版:

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": ["/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"
      }
    }
  }
}

故障排除

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

安全注意事项

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

📄 许可证

MIT

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client