README
🚀 MCP 服务器用于 FTP 访问
此 Model Context Protocol (MCP) 服务器为与 FTP 服务器交互提供了工具。它允许 Claude.app 列出目录内容、下载和上传文件、创建目录以及删除文件/目录,极大地提升了文件管理的便捷性。
🚀 快速开始
此 Model Context Protocol (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使用 FTPS(安全的 FTP),如果您的服务器支持它。- 服务器在系统临时目录中创建上传和下载的临时文件。
📄 许可证
MIT
Scan to contact