TechMCP

🎓 TechMCP - PSG College of Technology MCP Server

TechMCPis a comprehensive Model Context Protocol (MCP) server that seamlessly integrates with PSG College of Technology's e-campus portal. It provides AI assistants like Claude, Cursor, and Raycast with direct access to student academic data including CA marks, attendance records, and timetable information.

🚀Server hosting coming soon!No more local setup required.

- CA1 & CA2 Marks: Fetch continuous assessment marks for individual subjects or all subjects
- Assignment Marks: Get assignment scores for theory courses
- Tutorial Marks: Access tutorial marks and MPT scores
- Subject Search: Search by subject code or subject name
- Health Monitoring: Built-in health checks for scraper status

- Attendance Percentage: Real-time attendance tracking for all subjects
- Present/Absent Hours: Detailed hour-wise attendance breakdown
- Bunk Calculator: Smart calculation of available bunks while maintaining minimum attendance
- Subject-wise Analysis: Individual subject attendance details
- Attendance Alerts: Monitor attendance status across all courses

- Live Schedule: Get current day's complete timetable
- Next Class: Find your immediate next class with location details
- Remaining Classes: See what's left for today
- Weekly Schedule: Complete week view with all subjects
- Break Schedule: Track break times and current break status
- Tomorrow's Schedule: Plan ahead with next day's timetable
- Day-specific Schedule: Get timetable for any day of the week

- Course Directory: Complete list of all available courses
- Course Search: Find courses by code or name
- Detailed Course Info: Get comprehensive course details including timetable
- Subject Mapping: Automatic mapping between course codes and names

- CGPA Calculator: Calculate current CGPA and predict future performance
- CA Schedule: Upcoming continuous assessment dates
- Semester Schedule: Important academic dates and deadlines

- Python 3.10+
- Valid PSG Tech e-campus credentials
- Internet connectionfor portal access

git clone https://github.com/codit04/TechMCP.git cd TechMCP

⚠️ IMPORTANT: Youmustupdate theconfig.jsonfile with your PSG Tech e-campus credentials:

{ "credentials": { "roll_number": "YOUR_ACTUAL_ROLL_NUMBER", "password": "YOUR_ACTUAL_PASSWORD" }, "server": { "host": "localhost", "port": 8080, "sse_mode": true } }

The server will start onhttp://127.0.0.1:8080/sseand be ready for MCP connections.
- Create~/.cursor/mcp.jsonwith the following content:

{ "mcpServers": { "techmcp": { "url": "http://127.0.0.1:8080/sse", "name": "TechMCP - PSG Tech Integration", "transport":"sse" } } }

- Restart Cursor IDE
- The server will appear in your MCP settings
- Start asking questions like:"What are my CA1 marks?"or"What's my next class?"

# From the TechMCP directory mcp install server.py

- Restart Claude Desktop
- The TechMCP server will be available in Claude's tools panel
- Ask Claude about your academic data directly!
- Ensure the server is running onhttp://127.0.0.1:8080/sse
- Install a compatible MCP extension for Raycast
- Configure the server URL in Raycast settings
- Access your academic data through Raycast commands

- get_ca1_subject_mark- Get CA1 mark for a specific subject
- get_ca2_subject_mark- Get CA2 mark for a specific subject
- get_ca1_all_marks- Get CA1 marks for all subjects
- get_ca2_all_marks- Get CA2 marks for all subjects
- get_assignment_mark_by_subject- Get assignment marks for a subject
- get_all_assignment_marks- Get all assignment marks
- get_tutorial_marks_by_subject- Get tutorial marks for a subject
- get_all_tutorial_marks- Get all tutorial marks
- list_available_subjects- List all available subjects
- health_check- Check scraper health status

- get_subject_attendance_percentage- Get attendance % for a subject
- get_all_attendance_percentages- Get attendance % for all subjects
- get_subject_absent_hours- Get absent hours for a subject
- get_all_absent_hours- Get absent hours for all subjects
- get_subject_present_hours- Get present hours for a subject
- get_all_present_hours- Get present hours for all subjects
- get_subject_available_bunks- Calculate available bunks for a subject
- get_all_available_bunks- Calculate available bunks for all subjects

- get_next_class- Get your next scheduled class
- get_todays_schedule- Get today's complete schedule
- get_schedule_from_now- Get remaining classes for today
- get_tomorrows_schedule- Get tomorrow's schedule
- get_schedule_for_day- Get schedule for a specific day
- get_weekly_schedule- Get complete weekly timetable
- get_break_schedule- Get break times and current status

- get_all_courses- Get list of all courses
- search_courses- Search courses by name or code
- get_course_details- Get detailed course information

"What are my CA1 marks for Data Structures?" "Show me my attendance percentage for all subjects" "What's my next class?" "How many hours can I bunk in Computer Networks while maintaining 75% attendance?" "What's my complete schedule for tomorrow?"

# Get CA1 marks for a subject curl -X POST http://127.0.0.1:8080/mcp \ -H "Content-Type: application/json" \ -d '{"method": "get_ca1_subject_mark", "params": {"subject": "20XTO1"}}'

We welcome contributions to improve TechMCP! Here's how you can help:
- Forkthe repository
- Createa feature branch (git checkout -b feature/amazing-feature)
- Commityour changes (git commit -m 'Add amazing feature')
- Pushto the branch (git push origin feature/amazing-feature)
- Opena Pull Request

- GitHub Issues:Create an issuefor bugs or feature requests
- Discord Community: Join our discussion at@discord.gg/fRFGPQKERJ

- @mathanamathav- Inspiration from thebunker-apiproject
- PSG College of Technology- For the excellent e-campus portal
- E-Campus Portal- The source of all academic data

This project is licensed under the MIT License - see theLICENSEfile for details.

⭐ Star this repo|🐛 Report Bug|💬 Join Discord

Real-time stock heatmaps and investment tools delivered as interactive React components.