🎓 TechMCP - PSG College of Technology MCP Server

TechMCP is 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.

✨ Features

📊 CA Marks & Assessment Tools

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

• 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

🕒 Smart Timetable System

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

• 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

🔮 Coming Soon

• CGPA Calculator: Calculate current CGPA and predict future performance

• CA Schedule: Upcoming continuous assessment dates

• Semester Schedule: Important academic dates and deadlines

Related MCP server: Student MCP Server

📋 Prerequisites

• Python 3.10+

• Valid PSG Tech e-campus credentials

• Internet connection for portal access

🚀 Installation

1. Clone the Repository

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

2. Install Dependencies

pip install -r requirements.txt

3. Configure Credentials

⚠️ IMPORTANT: You must update the config.json file 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
    }
}

4. Start the Server

python server.py

The server will start on http://127.0.0.1:8080/sse and be ready for MCP connections.

🔗 Connecting to AI Assistants

🖱️ Cursor IDE

1. Create the MCP configuration directory:

mkdir -p ~/.cursor

2. Create ~/.cursor/mcp.json with the following content:

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

3. Restart Cursor IDE

4. The server will appear in your MCP settings

5. Start asking questions like: "What are my CA1 marks?" or "What's my next class?"

🤖 Claude Desktop

1. Install the server locally:

# From the TechMCP directory
mcp install server.py

2. Restart Claude Desktop

3. The TechMCP server will be available in Claude's tools panel

4. Ask Claude about your academic data directly!

⚡ Raycast

1. Ensure the server is running on http://127.0.0.1:8080/sse

2. Install a compatible MCP extension for Raycast

3. Configure the server URL in Raycast settings

4. Access your academic data through Raycast commands

🛠️ Available Tools

Marks & Assessment

• 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

Attendance Management

• 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

Timetable & Schedule

• 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

Course Information

• get_all_courses - Get list of all courses

• search_courses - Search courses by name or code

• get_course_details - Get detailed course information

💡 Usage Examples

With Cursor/Claude

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

Direct API Usage

# 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"}}'

🤝 Contributing

We welcome contributions to improve TechMCP! Here's how you can help:

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

🐛 Issues & Suggestions

• GitHub Issues: Create an issue for bugs or feature requests

• Discord Community: Join our discussion at @discord.gg/fRFGPQKERJ

🙏 Acknowledgments

• @mathanamathav - Inspiration from the bunker-api project

• PSG College of Technology - For the excellent e-campus portal

• E-Campus Portal - The source of all academic data

⚖️ Legal & Privacy

• This project is for educational purposes only

• Uses your own credentials to access your own data

• No data is stored or transmitted to external servers

• Respects PSG Tech's e-campus terms of service

• Open source and transparent

📄 License

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

🔧 Technical Details

• Framework: FastMCP 2.0+

• Web Scraping: Beautiful Soup 4, httpx

• Data Models: Pydantic

• Transport: Server-Sent Events (SSE)

• Authentication: Session-based with CSRF protection

Made with ❤️ for PSG Tech Students

Simplifying academic data access through AI

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