MCP Server Beginner App

🚀 多用戶 MCP 服務器帶聊天機器人和代理

這是一個完整的全棧網絡應用程序，實現模型上下文協議 (MCP)，為用戶提供聊天機器人類的對話式問答體驗，以及代理類的工具使用AI代理體驗。具備用戶身份驗證、聊天記錄持久化、即時消息傳遞和文件上傳分析等功能，可部署在 Heroku 上。

🚀 快速開始

本項目是一個完整的全棧網絡應用程序，實現了模型上下文協議 (MCP)，提供兩種人工智能助手體驗，分別是聊天機器人的對話式問答和代理的工具使用。它具備用戶身份驗證、持久的聊天記錄、即時 WebSocket 消息傳遞以及文檔分析的文件上傳等功能，並且已準備好投入生產，可部署在 Heroku 上。

✨ 主要特性

• 用戶身份驗證：支持註冊、登錄、密碼恢復以及電子郵件驗證功能。
• 雙 AI 接口：提供聊天機器人和代理兩種 AI 接口，且各有獨特功能。
• 即時聊天：基於 WebSocket 實現即時消息傳遞。
• 對話歷史記錄：為每個用戶持久保存特定的聊天日誌。
• 文件上傳：支持在聊天中上傳文件進行文檔分析。
• MCP 服務器集成：可連接多個 MCP 服務器以執行工具。
• 響應式 UI：前端採用 HTML、CSS、純 JavaScript 構建，界面乾淨且適配移動設備。
• Heroku 部署就緒：可直接在雲端 Heroku 上進行部署。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/yourusername/multi-user-mcp.git
   cd multi-user-mcp
   

2. 安裝依賴項：

   pip install fastapi uvicorn motor python-multipart
   

3. 運行應用程序：

   uvicorn main:app --reload
   

📚 詳細文檔

項目結構

.
├── main.py                # FastAPI 應用程序入口點
├── routes/                # API 路由處理程序（認證、聊天機器人、代理、反饋）
├── static/                # 前端 HTML、CSS、JS 對所有頁面
│   ├── chatbot/           # 聊天機器人的前端界面
│   ├── agent/             # 代理的前端界面
│   └── common/           # 共用的前端資源
├── config.py             # 應用程序配置文件
└── README.md              # 項目文檔

目標

本項目旨在展示如何使用現代 Web 技術和人工智能構建一個多用戶 AI 代理和聊天機器人服務器。通過 FastAPI 提供高效的 API，結合 WebSocket 實現即時通信，並利用 MongoDB 存儲數據。

如何使用

1. 訪問主頁：http://localhost:8000
2. 註冊新用戶：填寫表格並提交。
3. 登錄：使用註冊的郵箱和密碼登錄。
4. 與聊天機器人交互：在聊天界面輸入問題或命令。
5. 代理功能：通過代理界面執行復雜任務。

安全注意事項

• 所有 API 請求都經過身份驗證和授權。
• 使用 HTTPS 部署在生產環境中以確保數據安全。
• 定期更新依賴項以防止安全漏洞。

貢獻指南

歡迎貢獻！請參考 CONTRIBUTING.md 瞭解如何參與開發。

參考資料

• FastAPI 官方文檔
• MongoDB 官方文檔
• OpenAI API 文檔
• Heroku 開發指南

聯繫方式

如有任何問題或反饋，請聯繫：

• 郵箱：contact@yourdomain.com
• GitHub：你的GitHub鏈接

🔧 技術細節

技術堆棧

📄 許可證

本項目遵循 MIT 許可證。請查看 LICENSE 瞭解更多詳細信息。