Eclass MCP Server

🚀 eClass MCP 服務器

eClass MCP 服務器提供了一個獨立於官方平臺的接口，支持與支持模型上下文協議（MCP）的 AI 代理直接交互，可用於檢索 eClass 課程信息等，且確保了憑證處理的安全性。

🚀 快速開始

eClass 是希臘大學網絡 (GUnet) 開發和維護的開源學習管理系統，用於希臘學術機構。本項目提供了一個獨立於官方平臺的接口，並尊重其使用條款和服務條款。

✨ 主要特性

• AI 集成：支持與支持模型上下文協議（Model Context Protocol, MCP）的 AI 代理（如 Claude 或其他大語言模型（LLMs））直接交互。
• 課程信息：可以檢索課程信息、查看公告、訪問材料和提交作業（未來功能）。
• 安全設計：確保憑證處理的安全性，防止敏感數據洩露。

🔧 技術細節

核心組件

1. MCP 服務器

   • 在本地運行。
   • 不依賴任何雲服務。
   • 通過環境變量存儲憑證。
   • 使用隨機字符串作為佔位符參數。

2. AI 客戶端隔離

   • AI 客戶端無法訪問真實憑證。
   • 防止憑證被存儲或處理在遠程服務器。
   • 確保所有操作直接與 eClass 通信。

核心協議

• 使用環境變量存儲配置信息：e_class_host, e_class_username, e_class_password。
• 支持的工具命令：
  • login：初始化會話並獲取 CAS 票據。
  • get_courses：返回當前登錄用戶的所有課程列表。
  • logout：註銷當前會話。

安全機制

• 本地運行：服務器在本地執行，不使用任何雲服務。
• 內存化會話管理：會話 cookie 和狀態僅存儲在內存中，不會持久化到磁盤。
• 直接認證：通過大學的 CAS 機制與 eClass 直接通信。

💻 使用示例

基礎用法

import asyncio
from eclass_mcp_client import MCPClient, ServerConfig

async def main():
    # 配置服務器參數
    server_config = ServerConfig(
        host="your_e_class_url",
        username="your_username",
        password="your_password"
    )

    async with MCPClient(server_config) as client:
        try:
            # 登錄
            login_result = await client.call_tool("login", {"random_string": "dummy"})
            print(login_result)

            # 獲取課程列表
            courses_result = await client.call_tool("get_courses", {"random_string": "dummy"})
            print(courses_result)

            # 註銷
            logout_result = await client.call_tool("logout", {"random_string": "dummy"})
            print(logout_result)
        except Exception as e:
            print(f"Error occurred: {e}")

if __name__ == "__main__":
    asyncio.run(main())

📚 詳細文檔

安全注意事項

憑證保護

• 環境變量存儲：憑證僅存放在本地 .env 文件中。
• 避免明文傳輸：所有工具使用隨機字符串作為佔位符，AI 客戶端無法獲取真實憑證。
• 物理機隔離：只在受信任的設備上運行。

推薦實踐

• 不要將 .env 文件提交到版本控制中。
• 及時清理不再使用的服務器實例。
• 使用強密碼策略保護用戶賬戶。

許可證信息

本項目遵循 GNU 通用公共許可證第 3 版（GPLv3），允許免費使用、修改和分發，但必須在重新分發或派生作品中包含原始版權聲明。

通過以上介紹，eClass MCP 服務器為開發者提供了一個安全可靠的方式來集成 AI 代理與學習管理系統之間的交互。