🎓 MyCourseVille → AI

⚡ 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.

Related MCP server: Canvas LMS MCP Server

🚀 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 for installation steps

Option B (Still Easy)

Clone and run:

git clone https://github.com/Helpmepeet/MCV_MCP.git
cd MCV_MCP
pip install -r requirements.txt

Add your credentials:

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:

{
  "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

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

• Built with Model Context Protocol

⚠️ Disclaimer

Not affiliated with Chulalongkorn University / MyCourseVille.

Use responsibly. Respect the platform's terms of service.

📖 More Docs

• AI_AGENT_GUIDE.md — For AI agents installing this

• ARCHITECTURE.md — Technical details

• CONTRIBUTING.md — How to contribute

• CHANGELOG.md — Version history

Made with ❤️ for Chula students who want AI to handle the boring stuff