Scan to contactarticle
README
🚀 文件管理器 MCP 📂
一个强大且用户友好的文件管理器应用程序，提供现代界面用于管理 FTP 文件操作。借助 AI 提示工程开发，整个代码库是与 AI 协作的成果，展现了现代 AI 辅助开发实践的潜力。
🚀 快速开始
本文件管理器有两种使用方式，推荐使用 smithery 托管服务，若你想本地安装也没问题，下面为你详细介绍。
使用 smithery 托管服务（推荐）
- 访问 File Manager on smithery。
- 创建一个账户或登录。
- 使用你偏好的开发环境连接，如 Visual Studio Code、Cursor 或任何具有 MCP 集成的 IDE 或工具。
替代方案：本地安装
如果你更喜欢在本地运行应用程序，请按以下步骤操作：
- 确保已安装 .NET 9.0 SDK。
- 按照下面的步骤构建并运行应用程序。
在本地构建和运行
- 克隆仓库：
- HTTPS 方式：
git clone https://github.com/taha-ghadirian/FileManagerMcp.git- SSH 方式：
git clone git@github.com:taha-ghadirian/FileManagerMcp.gitcd FileManagerMcp - 安装依赖项：
dotnet restore
- 构建项目：
dotnet build
- 使用 inspector 运行应用程序：
npx @modelcontextprotocol/inspector dotnet run
✨ 主要特性
- 📁 检查和管理远程 FTP 目录
- ⬆️ 上传文件和目录
- ⬇️ 下载文件和目录
- 🗑️ 删除文件和目录
- 📝 创建新目录
- 🔄 递归文件操作支持
- 💻 清洁且直观的用户界面
🔧 配置
该应用程序使用环境变量进行配置，以下是所需的环境变量：
| 选项 | 描述 | 必填 | 默认值 |
|------|------|------|------|
| ftpHost | FTP 服务器主机名或 IP 地址 | 是 | - |
| ftpUsername | FTP 帐户用户名 | 是 | - |
| ftpPassword | FTP 帐户密码 | 是 | - |
| ftpPort | FTP 服务器端口 | 否 | 21 |
你可以以多种方式设置这些环境变量，例如在运行应用程序时内联设置：
ftpHost=ftp.example.com ftpUsername=myuser ftpPassword=mypassword npx @modelcontextprotocol/inspector dotnet run
⚠️ 重要提示
不要将敏感信息如密码提交到版本控制。始终使用环境变量或安全的秘密管理对于生产部署。
🤝 贡献
欢迎贡献！请随意提交 Pull Request。
- 提交代码时，请确保遵循标准的 Git 工作流程。
- 为你的更改提供清晰的说明，并参考 如何撰写良好的提交信息。
- 如果你在项目中引用了任何资源或依赖项，请在
package.json或其他适当的文件中标明。
📄 许可证
本项目遵循 GPL-3.0 协议。请确保在重新分发或修改时遵守许可证条款。
💡 联系方式
如果有任何问题或反馈，请通过以下方式联系：
- 邮件：contact@yourdomain.com
- GitHub：@你的GitHub用户名
感谢你对项目的支持！