MCP Server Beginner App

🚀 Multi-User MCP Server with Chatbot and Agent

A full-stack web application implementing the Model Context Protocol (MCP) to offer two AI assistant experiences:

• Chatbot: Conversational Q&A
• Agent: Tool-using AI agent

Features include user authentication, persistent chat history, real-time WebSocket messaging, and file uploads for document analysis. The application is production-ready and can be deployed on Heroku.

🚀 Quick Start

This is a complete full-stack web application that implements the Model Context Protocol (MCP) to provide two AI assistant experiences: chatbot and agent. It includes features like user authentication, persistent chat history, real-time WebSocket messaging, and file uploads for document analysis. The application is ready for production and can be deployed on Heroku.

✨ Features

• User Authentication: Registration, login, password recovery, email verification
• Dual AI Interfaces: Chatbot and agent, each with unique capabilities
• Real-time Chat: WebSocket-based instant messaging
• Conversation History: Persistent, user-specific chat logs
• File Upload: Analyze documents within the chat
• MCP Server Integration: Connect to multiple MCP servers to execute tools
• Responsive UI: Clean, mobile-friendly HTML/CSS/JS front-end
• Heroku Deployment Ready: Prepared for cloud deployment

🛠️ Technical Stack

• Backend: Python 3.10+, FastAPI, MongoDB, Uvicorn
• Frontend: HTML, CSS, pure JavaScript (see static/)
• AI Integration: OpenAI API or compatible LLM providers
• Real-time Communication: WebSocket
• Deployment: Heroku (includes Procfile)

📁 Project Structure

.
├── main.py                # FastAPI application entry point
├── routes/                # API route handlers (authentication, chatbot, agent, feedback)
├── static/                # Frontend HTML, CSS, JS for all pages
│   ├── chatbot/           # Frontend interface for the chatbot
│   ├── agent/             # Frontend interface for the agent
│   └── common/           # Shared frontend resources
├── config.py             # Application configuration file
└── README.md              # Project documentation

📦 Installation

1. Clone the repository:

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

2. Install dependencies:

   pip install fastapi uvicorn motor python-multipart
   

3. Run the application:

   uvicorn main:app --reload
   

🎯 Objectives

This project aims to demonstrate how to build a multi-user AI agent and chatbot server using modern web technologies and artificial intelligence. It uses FastAPI to provide efficient APIs, WebSocket for real-time communication, and MongoDB for data storage.

💻 Usage Examples

Basic Usage

1. Access the homepage: http://localhost:8000
2. Register a new user: Fill out the form and submit.
3. Log in: Use the registered email and password to log in.
4. Interact with the chatbot: Enter questions or commands in the chat interface.
5. Use the agent: Execute complex tasks through the agent interface.

🛡️ Security Considerations

• All API requests are authenticated and authorized.
• Use HTTPS for production deployment to ensure data security.
• Regularly update dependencies to prevent security vulnerabilities.

🤝 Contribution Guidelines

Contributions are welcome! Please refer to CONTRIBUTING.md for details on how to contribute to the development.

📄 License

This project is licensed under the MIT License. See LICENSE for more details.

📚 References

• FastAPI Official Documentation
• MongoDB Official Documentation
• OpenAI API Documentation
• Heroku Development Guide

Contact

If you have any questions or feedback, please contact:

• Email: contact@yourdomain.com
• GitHub: Your GitHub Link