自然语言文件管理系统

File Change是一个全栈应用程序,允许用户使用自然语言命令管理文件和文件夹,具有React前端和Node.js后端,支持Google云存储和OpenAI命令处理。

  • by Sans25VS
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 sans25vs/full-stack-mcp-server

使用说明

📁 文件更改-自然语言文件管理系统

File Change是一个全栈应用程序,允许您使用自然语言命令管理文件和文件夹。它具有一个React前端和一个由Express支持的Node.js后端,OpenAI用于命令处理,Google Cloud Storage用于持久文件存储。

[托管URL]-(https://full-stack-mcp-server.vercel.app/)

✨ 特性

  • 自然语言命令:使用纯英语创建、编辑和删除文件。
  • 文件和文件夹上传:轻松上传文件或整个文件夹。
  • 云存储:文件安全地存储在Google Cloud Storage中。
  • 文件查看器:直接在应用程序中查看基于文本的文件的内容。
  • 现代用户界面:使用React构建的干净、响应迅速、直观的用户界面。
  • 实时反馈:加载所有操作的指示器和吐司通知。
  • 可扩展:后端架构是模块化的,易于扩展。

🚀 现场演示

[链接到已部署的应用程序]

🛠️ 技术栈

  • 前端:React.js、CSS
  • 后端:Node.js、Express.js
  • 文件存储:谷歌云存储
  • 人工智能:OpenAI API
  • 文件上传:Multer
  • 部署:Vercel(或任何其他平台)

📂 项目结构

该项目是一个包含两个主要目录的monorepo:

  • /client:包含React前端应用程序。
  • /server:包含Node.js后端服务器。

每个目录都有自己的 package.json 以及依赖关系。


🔧 设置和安装

先决条件

1.克隆存储库

gh repo clone Sans25VS/Full-Stack-MCP-SERVER
cd Full-Stack-MCP-SERVER

2.设置后端(/server)

  1. 导航到服务器目录:

    cd server
    
  2. 安装依赖项:

    npm install
    
  3. 创建一个 .env 文件在 /server 目录并添加以下环境变量。看 GOOGLE_CLOUD_SETUP.md 有关设置Google Cloud的更多详细信息。

    # Server Configuration
    PORT=3001
    NODE_ENV=development
    
    # OpenAI Configuration
    OPENAI_API_KEY=your_openai_api_key_here
    
    # Google Cloud Storage Configuration
    GOOGLE_CLOUD_PROJECT_ID=your_gcp_project_id
    GOOGLE_CLOUD_BUCKET_NAME=your_gcs_bucket_name
    # For Vercel/production, use GOOGLE_CLOUD_CREDENTIALS instead of the key file
    GOOGLE_CLOUD_CREDENTIALS='{"type": "service_account", ...}'
    # For local development, you can use a key file
    # GOOGLE_CLOUD_KEY_FILE=path/to/your/service-account-key.json
    
    # Uploads Directory (for local development fallback)
    UPLOADS_DIR=./uploads
    
  4. 启动开发服务器:

    npm run dev
    

    服务器将在上运行 http://localhost:3001.

3.设置前端(/client)

  1. 从根目录导航到客户端目录:

    cd client
    
  2. 安装依赖项:

    npm install
    
  3. 默认情况下,前端配置为连接到已部署的后端。对于本地开发,您可以更改 API_BASE_URL 在……里面 client/src/config.js 向 http://localhost:3001.

  4. 启动开发服务器:

    npm start
    

    客户端将在上运行 http://localhost:3000.

📜 可用脚本

服务器(/server)

  • npm start:以生产模式启动服务器。
  • npm run dev:以开发模式启动服务器 nodemon.

客户(/client)

  • npm start:以开发模式运行应用程序。
  • npm run build:构建用于生产的应用程序。
  • npm test:运行测试套件。

🔌 API终点

服务器公开以下REST API终结点:

方法 端点 描述
POST /upload 上传一个或多个文件。
GET /files 检索所有文件的列表。
GET /files/:filename 检索特定文件的内容。
POST /command 处理自然语言命令。
GET /health 健康检查端点。

🖼️ 截图

📄 许可证

该项目根据MIT许可证获得许可。请参阅 LICENSE 文件以获取详细信息。