Eclass MCP Server

🚀 eClass MCP サーバー

eClass MCP サーバーは、ギリシャの大学機関向けのオープンソース学習管理システムである eClass と、AI エージェントとの安全なやり取りを可能にする独立したインターフェースを提供します。このプロジェクトは、公式プラットフォームの利用規約を尊重して開発されています。

🚀 クイックスタート

eClass MCP サーバーを使用することで、eClass と AI エージェントを安全に連携させることができます。以下の手順に沿って、システムをセットアップしてください。

✨ 主な機能

• AI 統合：モデルコンテキストプロトコル（Model Context Protocol, MCP）をサポートする AI エージェント（Claude や他の大規模言語モデルなど）と直接やり取りできます。
• コース情報：コース情報を検索し、公告を確認し、教材にアクセスし、宿題を提出（将来的な機能）できます。
• セキュリティ設計：認証情報の取り扱いを安全に行い、機密データの漏洩を防止します。

📦 インストール

インストールに関する具体的な手順は原ドキュメントに記載されていないため、このセクションをスキップします。

💻 使用例

基本的な使用法

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())

高度な使用法

原ドキュメントに高度な使用法に関するコード例がないため、このセクションをスキップします。

📚 ドキュメント

コアコンポーネント

1. MCP サーバー
   • ローカルで実行され、クラウドサービスに依存しません。
   • 環境変数を使用して認証情報を保存します。
   • ランダムな文字列でパラメータを置き換えます。
2. AI クライアントの分離
   • AI クライアントは実際の認証情報にアクセスできません。
   • 認証情報がリモートサーバーに保存または処理されることを防止します。
   • すべての操作が直接 eClass と通信することを保証します。

技術構造

コアプロトコル

• 環境変数を使用して設定情報を保存します：e_class_host, e_class_username, e_class_password
• サポートされるツールコマンド：
  • login：セッションを初期化し、CAS チケットを取得します。
  • get_courses：現在ログインしているユーザーのすべてのコースリストを返します。
  • logout：現在のセッションを終了します。

セキュリティメカニズム

• ローカル実行：サーバーはローカルで実行され、クラウドサービスを使用しません。
• メモリ内セッション管理：セッションクッキーと状態はメモリ内にのみ保存され、ディスクに永続化されません。
• 直接認証：大学の CAS メカニズムを介して eClass と直接通信します。

🔧 技術詳細

原ドキュメントに技術的な詳細説明が十分に記載されていないため、このセクションをスキップします。

📄 ライセンス

このプロジェクトは GNU 一般公衆利用許諾契約書第 3 版（GPLv3）に基づいてライセンスされています。これにより、無料で使用、変更、再配布することができますが、再配布や派生作品には元の著作権表示を含める必要があります。

⚠️ 重要提示

• 認証情報は環境変数を使用してローカルの .env ファイルに保存してください。
• すべてのツールはランダムな文字列でパラメータを置き換えるため、AI クライアントが実際の認証情報にアクセスすることはありません。
• 信頼できるデバイスでのみシステムを実行してください。

💡 使用建议

• .env ファイルをバージョン管理システムにコミットしないでください。
• 使用しなくなったサーバーインスタンスはすぐに削除してください。
• 強力なパスワードポリシーを使用してユーザーアカウントを保護してください。