MCP Server

What is MCP Server?

MCP Server generates Master Content Plans (MCPs) based on a topic. It aggregates web resources and organizes them into structured learning paths, suitable for any subject.

How to use MCP Server?

Clone the repository, create a Python virtual environment, install dependencies (pip install -r requirements.txt and npm install), and install Chrome/Chromium for Pyppeteer. Start the server with uvicorn main:app --reload --host 0.0.0.0 --port 8000 or run the provided batch file. Generate an MCP via GET /generate_mcp?topic=your_topic. The production server is at https://reunemacacada.onrender.com.

Key features of MCP Server

• Generates learning paths for any topic
• Web search and scraping to find relevant resources
• Customizable number of nodes and tree structure
• Supports multiple languages, with focus on Portuguese
• TF-IDF based resource relevance filtering
• YouTube integration for video inclusion
• Asynchronous task system with real-time progress
• Caching system for faster repeated requests

Use cases of MCP Server

• Generate a structured learning path for a programming language (e.g., Python)
• Create a study plan for a historical topic (e.g., Brazilian history)
• Build a learning tree for a non‑technology subject (e.g., finance, health)
• Offload long‑running generation into async tasks to avoid timeouts
• Cache and reuse results for frequently requested topics