文件管理器 MCP 📂

一个强大且用户友好的文件管理器应用程序，提供现代界面来管理FTP文件操作。

🤖 AI驱动开发：此项目是通过AI提示工程进行编码的结果。整个代码库是在与AI协作下开发的，展示了现代AI辅助开发实践的潜力。

🚀 特性

• 📁 浏览和管理远程FTP目录
• ⬆️ 上传文件和目录
• ⬇️ 下载文件和目录
• 🗑️ 删除文件和目录
• 📝 创建新目录
• 🔄 支持递归文件操作
• 💻 清晰直观的用户界面

🚀 使用方法

使用 Smithery 托管服务（推荐）

1. 访问 Smithery 上的文件管理器

2. 注册账户或登录

3. 使用您偏好的开发环境连接：

   • Visual Studio Code
   • Cursor
   • 任何具有MCP集成的IDE或工具

替代方案：本地安装

如果您希望在本地运行该应用程序，请按照以下步骤操作：

1. 确保已安装 .NET 9.0 SDK
2. 按照下面的安装步骤构建并运行应用程序

🛠️ 本地构建和运行

1. 克隆仓库：

   HTTPS:

   git clone https://github.com/taha-ghadirian/FileManagerMcp.git
   

   SSH:

   git clone git@github.com:taha-ghadirian/FileManagerMcp.git
   

   然后导航到项目目录：

   cd FileManagerMcp
   

2. 安装依赖项：

dotnet restore

3. 构建项目：

dotnet build

4. 在检查器中运行应用程序：

npx @modelcontextprotocol/inspector dotnet run

🔧 配置

应用程序使用环境变量进行配置。以下是必需的环境变量：

选项	描述	必需	默认值
ftpHost	FTP服务器主机名或IP地址	是	-
ftpUsername	FTP账户用户名	是	-
ftpPassword	FTP账户密码	是	-
ftpPort	FTP服务器端口	否	21

您可以以多种方式设置这些环境变量：

1. 在运行应用程序时内联设置它们：

   ftpHost=ftp.example.com ftpUsername=myuser ftpPassword=mypassword npx @modelcontextprotocol/inspector dotnet run
   

⚠️ 安全注意事项：切勿将密码等敏感信息提交到版本控制中。始终使用环境变量或安全的秘密管理工具进行生产部署。

🤝 贡献

欢迎贡献！请随时提交拉取请求。

1. 分叉项目
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m '添加一些AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开拉取请求

📝 许可证

本项目根据GNU通用公共许可证v3.0许可 - 详情见LICENSE文件。这意味着：

• 您可以自由地使用、修改和分发此软件
• 如果您修改并分发此软件，您必须：
  • 提供源代码
  • 将您的修改许可为GPL v3.0
  • 文档化您的更改
  • 保留原始版权声明

📞 支持

如果您有任何问题或需要支持，请在GitHub存储库中打开一个问题。

✨ 致谢

• 感谢所有帮助塑造这个项目的贡献者
• 使用.NET和现代最佳实践构建

---

由Taha Ghadirian制作 ❤️