Eclass MCP Server

🚀 eClass モデルコンテキストプロトコル (MCP) サーバー

eClass MCP サーバーは、ローカルで動作するツールです。これにより、Claude やその他の大規模言語モデルなどの AI エージェントが、ギリシャの大学で使用されている Open eClass 学習管理システムと直接やり取りできるようになります。このサーバーは、ブラウザの動作を模倣し、大学が提供するユーザー名とパスワードを使用して eClass にログインし、AI に必要な情報を提供します。

✨ 主な機能

• ローカルでの実行：ユーザーのコンピューター上で完全に動作し、クラウドサービスに依存しません。
• セキュリティ設計：厳格な 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())

📚 ドキュメント

セキュリティの基本原則

• 最小限の権限：すべての操作はローカルで行われ、データはサーバーにアップロードされません。
• セキュリティ監査：ソースコードは厳格なセキュリティレビューを受けています。
• プライバシー保護：ユーザー情報はローカルでのみ使用され、転送や保存は行われません。

使用上の提案

• 環境の分離：MCP サーバーを仮想マシンまたはコンテナ内で実行します。
• 定期的な更新：最新バージョンを定期的にインストールして、セキュリティの改善を受けます。
• ログの監視：異常な活動やエラー情報に注意を払います。

📄 ライセンス

このプロジェクトは GPL - 3.0 ライセンスの下で提供されています。詳細については LICENSE ファイルを参照してください。

🤝 コントリビューションガイド

コミュニティからの貢献を歓迎します！開発への参加方法については CONTRIBUTING.md ドキュメントを参照してください。皆さんの参加を楽しみにしています！

付録

1. FAQ

Q：パスワードが漏洩するリスクはどのように処理すればよいですか？
A：仮想環境で実行し、定期的にパスワードを変更することをおすすめします。

Q：マルチスレッドをサポートしていますか？
A：現在のバージョンはシングルスレッドをサポートしており、将来的にマルチスレッドの最適化を予定しています。

2. 開発ドキュメント

• API ドキュメント：docs/api.md
• 設計ドキュメント：docs/design.md

eClass MCP サーバーのご利用を歓迎します！問題があれば、support@your-organization.com までご連絡ください。