Skip to main content
Glama

πŸŽ“ 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


⚠️ Disclaimer

Not affiliated with Chulalongkorn University / MyCourseVille.

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


πŸ“– More Docs


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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers