使用说明
📁 文件更改-自然语言文件管理系统
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 以及依赖关系。
🔧 设置和安装
先决条件
- Node.js (v14或更高版本)
- npm
- A. 谷歌云平台 帐户包含一个项目和一个存储桶。
- 一 OpenAI API密钥.
1.克隆存储库
gh repo clone Sans25VS/Full-Stack-MCP-SERVER
cd Full-Stack-MCP-SERVER
2.设置后端(/server)
-
导航到服务器目录:
cd server -
安装依赖项:
npm install -
创建一个
.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 -
启动开发服务器:
npm run dev服务器将在上运行
http://localhost:3001.
3.设置前端(/client)
-
从根目录导航到客户端目录:
cd client -
安装依赖项:
npm install -
默认情况下,前端配置为连接到已部署的后端。对于本地开发,您可以更改
API_BASE_URL在……里面client/src/config.js向http://localhost:3001. -
启动开发服务器:
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 文件以获取详细信息。
