Blog_System

# Blog Website and MCP Service System A modern blog website integrated with MCP (Model Context Protocol) services, providing a high-quality article reading experience and AI-enhanced features.   ## 📖 Project Overview This project builds a fully functional blog website while integrating MCP services to provide intelligent interaction capabilities. The project adopts an iterative development model, starting with the MVP (Minimum Viable Product) core features and gradually expanding to a complete system. ### Core Features - **Content Management System**: Supports the creation and display of articles with rich text, images, and videos - **Categories and Tags**: Multi-level categorization system and flexible tag management - **User System**: User authentication, role permissions, and profile management - **Search Functionality**: Full-text search and intelligent search recommendations - **MCP Services**: AI-enhanced features based on SSE (Server-Sent Events), including content analysis and search optimization - **Responsive Design**: User-friendly interface adaptable to different screen sizes - **Admin Panel**: Complete content and user management functionalities ## 🛠️ Tech Stack ### Frontend - **Core Framework**: React - **State Management**: Redux Toolkit - **Routing**: React Router - **HTTP Requests**: Axios - **UI Components**: Ant Design - **Styling**: CSS Flexbox/Grid ### Backend - **Web Framework**: FastAPI (Python) - **ORM**: SQLAlchemy - **Data Validation**: Pydantic - **Authentication**: JWT - **Documentation**: Swagger/OpenAPI ### Database - **RDBMS**: MySQL - **Migration Tool**: Alembic ### MCP Services - **Framework**: FastMCP, Starlette - **Communication Protocol**: SSE (Server-Sent Events) - **Caching**: Redis (optional) ### Deployment - **Containerization**: Docker - **Orchestration**: Docker Compose - **Web Server**: Nginx ## 📂 Project Structure ``` Blog_project/ ├── frontend/ # Frontend React application │ ├── public/ # Static resources │ ├── src/ # Source code │ │ ├── components/ # Common components │ │ ├── pages/ # Page components │ │ ├── layouts/ # Layout components │ │ ├── services/ # API services │ │ ├── store/ # Redux state management │ │ └── ... │ └── ... ├── backend/ # Backend Python application │ ├── app/ # Application code │ │ ├── api/ # API routes │ │ ├── core/ # Core configuration │ │ ├── db/ # Database models │ │ └── ... │ └── ... ├── mcp_service/ # MCP services │ ├── app/ # Application code │ │ ├── resources/ # Resource definitions │ │ ├── tools/ # Tool definitions │ │ ├── prompts/ # Prompt templates │ │ └── ... │ └── ... ├── docker/ # Docker configuration ├── doc/ # Project documentation └── README.md # This file ``` ## 🚀 Quick Start ### Prerequisites - Node.js 16+ - Python 3.8+ - MySQL 8.0+ - Docker and Docker Compose (optional, for containerized deployment) ### Installation and Running #### Frontend Development ```bash # Navigate to the frontend directory cd frontend # Install dependencies npm install # Start the development server npm start ``` #### Backend Development ```bash # Navigate to the backend directory cd backend # Create a virtual environment python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt # Configure environment variables cp .env.example .env # Edit the .env file and fill in the necessary configurations # Run database migrations alembic upgrade head # Start the development server uvicorn app.main:app --reload ``` #### MCP Services ```bash # Navigate to the MCP service directory cd mcp_service # Create a virtual environment python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt # Configure environment variables cp .env.example .env # Edit the .env file and fill in the necessary configurations # Start the service python main.py ``` ### Docker Deployment (Optional) ```bash # Build and start all services docker-compose up -d # Check the status of services docker-compose ps ``` ## 📝 Development Roadmap This project follows the MVP (Minimum Viable Product) development model, divided into the following iterations: ### Iteration One: MVP Core Blog Features ✅ - Basic framework setup ✅ - Article display functionality ✅ - Categories and simple search ✅ - Basic responsive design ✅ ### Iteration Two: User System and Basic Admin Panel 🔄 - User authentication and profile management - Basic admin panel - Article creation and editing functionality ### Iteration Three: MCP Service Integration ⏳ - MCP service infrastructure - Article resource implementation - Basic tools and prompt template implementation ### Iteration Four: Refinement and Optimization ⏳ - Enhanced search functionality - Improved tag system - Optimized responsive design - Performance optimization and MCP service enhancements ## 📚 Project Documentation Detailed project documentation is located in the `doc` directory: - [Requirements Document](./doc/1.需求文档-整理版.md): Detailed description of project requirements and features - [Technical Specifications](./doc/2.技术规范.md): Defines technical implementation plans - [Overall Project Planning Document](./doc/3.项目整体规划方案.md): Detailed project architecture and module design - [Project Execution Steps Document](./doc/4.项目执行步骤方案优化版.md): Phased implementation plan - [MCP Service Implementation Plan](./doc/MCP服务实施方案.md): Detailed design and implementation plan for MCP services ## 🔒 Security and Performance - User authentication uses JWT tokens and password hashing - API access control and request rate limiting - Database query optimization and caching strategies - MCP service security measures include token validation and prompt injection protection - Frontend code splitting and lazy loading optimization ## 👥 Contributing 1. Fork this repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add some amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request ## 📄 License [MIT](LICENSE)