Eclass MCP Server

🚀 eClass Model Context Protocol (MCP) Server

The eClass MCP Server is a locally - run tool that enables AI agents (such as Claude or other large language models) to directly interact with the Open eClass learning management system used by Greek universities. The server simulates browser behavior, logs into eClass using the university - provided username and password, and provides the necessary information for AI.

✨ Features

• Local Operation: It runs entirely on the user's computer without relying on any cloud services.
• Secure Design: It adopts a strict credential handling strategy to ensure data security.
• High Performance: It uses asynchronous IO to achieve efficient network communication.
• Modular Architecture: It is easy to expand and maintain.

📚 Functionality

Core Functions

• User Authentication: Supports single - sign - on for SAML and CAS protocols.
• Course Management: Retrieves information on elective courses and grades.
• Bulletin Board Integration: Views course announcements.
• Resource Access: Downloads course materials and notes.
• Assignment Submission: (Future feature) Submits online assignments.

Extensible Functions

• Automated Learning Process: Uses AI to analyze learning materials.
• Intelligent Reminders: Automatically sends notifications based on the calendar.
• Community Support: Integrates forums and discussion groups.

📦 Installation Guide

1. Environment Requirements

   • Operating System: Linux/Windows/MacOS
   • Python Version: 3.8+

2. Installation Steps

   git clone https://github.com/your-organization/eClass-MCP-Server.git
   cd eClass-MCP-Server
   pip install -r requirements.txt
   

3. Configure Environment Variables Create a .env file:

   ECLASS_USERNAME=your_username
   ECLASS_PASSWORD=your_password
   

4. Start the Server

   python -m eclass_mcp_server.run_server
   

💻 Usage Examples

Basic Usage

import asyncio
from eclass_mcp_client import MCPClient

async def main():
    async with MCPClient() as client:
        # Login
        login_response = await client.login({"random_string": "dummy"})
        print(login_response)
        
        # Get courses
        courses_response = await client.get_courses({"random_string": "dummy"})
        print(courses_response)
        
        # Logout
        logout_response = await client.logout({"random_string": "dummy"})
        print(logout_response)

asyncio.run(main())

🔧 Security Instructions

Core Principles

• Least Privilege: All operations are performed locally, and no data is uploaded to the server.
• Security Audit: The source code has undergone strict security reviews.
• Privacy Protection: User information is only used locally and will not be transmitted or stored.

Usage Tips

⚠️ Important Note

All operations are carried out locally, and no data is uploaded to the server. The source code has been strictly audited for security, and user information is only used locally without being transmitted or stored.

💡 Usage Tip

1. Environment Isolation: Run the MCP Server in a virtual machine or container.
2. Regular Updates: Install the latest version in a timely manner to obtain security improvements.
3. Monitor Logs: Pay attention to abnormal activities and error messages.

📄 License

This project is licensed under the GPL - 3.0 license. For more information, please refer to the LICENSE file.

🤝 Contribution Guidelines

Community contributions are welcome! Please refer to the CONTRIBUTING.md document to learn how to participate in the development. We look forward to your involvement!

Appendix

1. FAQ

Q: How to handle the risk of password leakage?
A: It is recommended to run in a virtual environment and change the password regularly.

Q: Does it support multi - threading?
A: The current version supports single - threading, and multi - threading optimization is planned for the future.

2. Development Documentation

• API Documentation: docs/api.md
• Design Documentation: docs/design.md

Welcome to use the eClass MCP Server! If you have any questions, please contact support@your-organization.com.