Trendy Post MCP

# Trendy Post MCP 🚀✨ A Model Context Protocol (MCP) service that: 1. Takes a screenshot from the user 📸 2. Uses OCR to extract text and analyze the image 🔍 3. Generates a trending Xiaohongshu-style post based on the content 📱💬 ## Features ✨ - **Image Processing** 🖼️: Extract text and analyze images - **Content Generation** 📝: Create engaging Xiaohongshu-style posts - **LLM Integration** 🧠: Uses AI to generate post styles, hashtags, and titles - **MCP Compatibility** 🔌: Works with any MCP client ## Setup 🛠️ This MCP uses the `trendy_post_mcp` conda environment with Python 3.12 and Surya OCR. ```bash # Activate the conda environment conda activate trendy_post_mcp # Run the MCP server python server.py ``` ## Usage 📋 Once the server is running, it can be used as an MCP service that provides functions for: - Processing screenshots 📸 - Analyzing image content 🔍 - Generating trending social media posts in the style of Xiaohongshu 📱 ### MCP Functions The server exposes the following MCP functions: - `process_screenshot`: Extract text from an image URL 🔤 - `generate_post`: Create a Xiaohongshu post from image analysis data ✍️ - `process_and_generate`: Combine both functions in one step (recommended) 🔄 - `health_check`: Check if the server is running properly 🩺 ## Project Structure 📁 - `server.py`: Main MCP server implementation - `image_processor.py`: Screenshot processing and OCR functionality - `post_generator.py`: Xiaohongshu post generation logic - `requirements.txt`: Python dependencies ## Dependencies 📦 ### OCR Engine This project uses [Surya OCR](https://github.com/VikParuchuri/surya) for text extraction, which is licensed under the **GPL-3.0 License**. Surya is a powerful OCR engine that supports multiple languages and provides excellent results for complex layouts. ⚠️ **Important License Note**: As Surya is licensed under GPL-3.0, any distribution of this software must comply with the GPL-3.0 license terms. Please ensure you understand these terms if you plan to distribute or modify this software. ### Other Dependencies - FastMCP: For MCP server implementation - Pydantic: For data validation - Pillow: For image processing - ZhipuAI: For LLM-based content generation ## License 📄 This project is licensed under the MIT License - see the LICENSE file for details. (Note: Components like Surya OCR have their own licenses as mentioned above)