Eclass MCP Server

🚀 eClass 模型上下文協議 (MCP) 服務器

eClass MCP 服務器是一款本地運行的工具，它能讓 AI 代理（如 Claude 或其他大語言模型）直接與希臘大學所用的 Open eClass 學習管理系統交互。該服務器通過模擬瀏覽器行為，利用大學提供的用戶名和密碼登錄 eClass，為 AI 提供所需信息。

🚀 快速開始

eClass MCP Server 可讓 AI 代理與 Open eClass 學習管理系統交互。以下是使用前的安裝和啟動步驟。

✨ 主要特性

• 本地運行：完全在用戶電腦上運行，不依賴任何雲服務。
• 安全設計：採用嚴格的 credential handling 策略，確保數據安全。
• 高性能：使用異步 IO 實現高效的網絡通信。
• 模塊化架構：易於擴展和維護。

💻 功能

核心功能

• 用戶認證：支持 SAML 和 CAS 協議的單點登錄。
• 課程管理：獲取選修課程信息和成績。
• 公告板集成：查看課程公告。
• 資源訪問：下載課程材料和筆記。
• 作業提交：（未來功能）提交在線作業。

可擴展功能

• 自動化學習流程：使用 AI 分析學習材料。
• 智能提醒：根據日曆自動發送通知。
• 社區支持：集成論壇和討論組。

📦 安裝指南

環境要求

• 操作系統：Linux/Windows/MacOS
• Python 版本：3.8+

安裝步驟

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

配置環境變量

創建 .env 文件：

ECLASS_USERNAME=your_username
ECLASS_PASSWORD=your_password

啟動服務器

python -m eclass_mcp_server.run_server

💻 使用示例

基礎用法

import asyncio
from eclass_mcp_client import MCPClient

async def main():
    async with MCPClient() as client:
        # 登錄
        login_response = await client.login({"random_string": "dummy"})
        print(login_response)
        
        # 獲取課程
        courses_response = await client.get_courses({"random_string": "dummy"})
        print(courses_response)
        
        # 退出
        logout_response = await client.logout({"random_string": "dummy"})
        print(logout_response)

asyncio.run(main())

📚 詳細文檔

安全說明

核心原則

• 最小權限：所有操作都在本地進行，不上傳任何數據到服務器。
• 安全審計：源代碼經過嚴格的安全審查。
• 隱私保護：用戶信息僅在本地使用，不會被傳輸或存儲。

使用建議

⚠️ 重要提示

為保障使用安全，請遵循以下建議。

💡 使用建議

1. 環境隔離：在虛擬機或容器中運行 MCP Server。
2. 定期更新：及時安裝最新版本以獲取安全性改進。
3. 監控日誌：關注異常活動和錯誤信息。

許可證

本項目採用 GPL - 3.0 協議，更多信息請查看 LICENSE 文件。

貢獻指南

歡迎社區貢獻！請參考 CONTRIBUTING.md 文檔瞭解如何參與開發。我們期待你的加入！

附錄

1. FAQ

Q：如何處理密碼洩露風險？
A：建議在虛擬環境中運行，並定期更換密碼。

Q：支持多線程嗎？
A：當前版本支持單線程，未來計劃加入多線程優化。

2. 開發文檔

• API 文檔：docs/api.md
• 設計文檔：docs/design.md

歡迎使用 eClass MCP Server！如有問題，請聯繫 support@your-organization.com。