# 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)
