🎓 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

📋 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