MCV_MCP

# 🎓 MyCourseVille → AI <img width="919" height="528" alt="image" src="https://github.com/user-attachments/assets/87e41bbe-12d1-4501-9c69-2da89acf8c86" /> ## ⚡ What This Is A local MCP server that lets your AI read your MyCourseVille data. - Assignments + deadlines - Submission status - Grades - Announcements - Course files/materials No more clicking around MCV. --- ## 🚀 Quick Install ### Option A (Tell Your AI) Tell your AI: > **"Install https://github.com/Helpmepeet/MCV_MCP and connect it as an MCP server"** Works best if your AI can run terminal commands. > 🤖 **For AI agents:** See [AI_AGENT_GUIDE.md](AI_AGENT_GUIDE.md) for installation steps ### Option B (Still Easy) Clone and run: ```bash git clone https://github.com/Helpmepeet/MCV_MCP.git cd MCV_MCP pip install -r requirements.txt ``` Add your credentials: ```bash cp .env.example .env # Edit .env with your MyCourseVille username/password ``` --- ## 🔐 Safe + Private - Runs on your machine - Your password stays local - No tracking - Open source **Not official from Chula.** --- ## 🧠 Example Questions - *"what's due this week?"* - *"any missing submissions?"* - *"what's the most urgent task?"* - *"show my scores"* - *"download materials from data mining"* --- ## 🛠 Connect to MCP (Claude Desktop) **1. Find your config file:** - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows:** `%APPDATA%/Claude/claude_desktop_config.json` - **Linux:** `~/.config/Claude/claude_desktop_config.json` **2. Add this:** ```json { "mcpServers": { "mycourseville": { "command": "python", "args": ["/absolute/path/to/MCV_MCP/server.py"], "env": { "MCV_USERNAME": "your_student_id", "MCV_PASSWORD": "your_password" } } } } ``` **3. Restart Claude Desktop** Done. --- ## 🧪 Test Without AI ```bash python mycourseville_client.py ``` Shows your homework in terminal. --- ## 🔧 Tools Exposed to AI 1. **`get_assignments`** — Fetch pending homework 2. **`get_assignment_detail`** — Check submission & grade 3. **`get_course_materials`** — List course files 4. **`get_announcements`** — Get course updates 5. **`mark_assignment_done`** — Hide completed tasks See [ARCHITECTURE.md](ARCHITECTURE.md) for details. --- ## 🆘 Troubleshooting **Login failed** → Check username/password in `.env` **No assignments** → Check semester/courses in MyCourseVille **MCP not working** → Use absolute path, restart Claude Desktop --- ## 📚 Requirements - Python 3.10+ - Chulalongkorn University MyCourseVille account - Claude Desktop or other MCP-compatible AI --- ## 🙏 Credits - AJAX API reverse-engineered from [kcnti/mycourseville-crispy](https://github.com/kcnti/mycourseville-crispy) - Built with [Model Context Protocol](https://modelcontextprotocol.io) --- ## ⚠️ Disclaimer **Not affiliated with Chulalongkorn University / MyCourseVille.** Use responsibly. Respect the platform's terms of service. --- ## 📖 More Docs - [AI_AGENT_GUIDE.md](AI_AGENT_GUIDE.md) — For AI agents installing this - [ARCHITECTURE.md](ARCHITECTURE.md) — Technical details - [CONTRIBUTING.md](CONTRIBUTING.md) — How to contribute - [CHANGELOG.md](CHANGELOG.md) — Version history --- **Made with ❤️ for Chula students who want AI to handle the boring stuff**