iflow-mcp_sdi2200262-eclass-mcp-server 0.1.0__py3-none-any.whl

eclass_mcp_server/test/run_all_tests.py

@@ -0,0 +1,185 @@
+"""Run all tests for the eClass MCP Server."""
+
+import asyncio
+import logging
+import os
+import sys
+
+from dotenv import load_dotenv
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '../..')))
+from eclass_mcp_server.server import (
+    handle_authstatus,
+    handle_get_courses,
+    handle_login,
+    handle_logout,
+    session_state,
+)
+
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger('run_all_tests')
+
+test_results = {
+    'login': False,
+    'authstatus_after_login': False,
+    'get_courses': False,
+    'logout': False,
+    'authstatus_after_logout': False
+}
+
+
+async def test_login() -> bool:
+    """Test the login functionality."""
+    print("\n=== Testing Login ===")
+    
+    load_dotenv()
+    
+    username = os.getenv('ECLASS_USERNAME')
+    password = os.getenv('ECLASS_PASSWORD')
+    
+    if not username or not password:
+        print("ERROR: ECLASS_USERNAME and ECLASS_PASSWORD must be set in the .env file.")
+        return False
+    
+    print("Attempting login...")
+    response = await handle_login()
+    
+    if not response:
+        print("ERROR: Empty response from login handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Login response: {text_content.text}")
+    
+    if "Login successful" in text_content.text:
+        print("Login test SUCCESS!")
+        return True
+    
+    print("Login test FAILED!")
+    return False
+
+
+async def test_authstatus() -> bool:
+    """Test the authentication status functionality."""
+    print("\n=== Testing Auth Status ===")
+    
+    print("Checking authentication status...")
+    response = await handle_authstatus()
+    
+    if not response:
+        print("ERROR: Empty response from authstatus handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Auth status response: {text_content.text}")
+    
+    if "Status: Logged in as" in text_content.text:
+        print("Auth status (logged in) test SUCCESS!")
+        return True
+    if "Status: Not logged in" in text_content.text and not session_state.logged_in:
+        print("Auth status (not logged in) test SUCCESS!")
+        return True
+    if "Status: Session expired" in text_content.text and not session_state.is_session_valid():
+        print("Auth status (session expired) test SUCCESS!")
+        return True
+    
+    print("Auth status test FAILED!")
+    return False
+
+
+async def test_get_courses() -> bool:
+    """Test the course retrieval functionality."""
+    print("\n=== Testing Course Retrieval ===")
+    
+    if not session_state.logged_in:
+        print("Not logged in, skipping course retrieval test.")
+        return False
+    
+    print("Retrieving courses...")
+    response = await handle_get_courses()
+    
+    if not response:
+        print("ERROR: Empty response from get_courses handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Course retrieval response: {text_content.text}")
+    
+    if "Error" in text_content.text:
+        print("Course retrieval test FAILED!")
+        return False
+    
+    if "No courses found" in text_content.text:
+        print("No courses found, but API worked correctly.")
+        print("Course retrieval test SUCCESS!")
+        return True
+    
+    if "Found" in text_content.text and "courses" in text_content.text:
+        if "URL:" in text_content.text:
+            print("Course retrieval test SUCCESS!")
+            return True
+        print("Course retrieval test FAILED! Output format is incorrect (missing URLs).")
+        return False
+    
+    print("Unexpected response from course retrieval.")
+    print("Course retrieval test FAILED!")
+    return False
+
+
+async def test_logout() -> bool:
+    """Test the logout functionality."""
+    print("\n=== Testing Logout ===")
+    
+    if not session_state.logged_in:
+        print("Not logged in, skipping logout test.")
+        return False
+    
+    print("Attempting logout...")
+    response = await handle_logout()
+    
+    if not response:
+        print("ERROR: Empty response from logout handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Logout response: {text_content.text}")
+    
+    if "Successfully logged out" in text_content.text:
+        print("Logout test SUCCESS!")
+        return True
+    
+    print("Logout test FAILED!")
+    return False
+
+
+async def run_all_tests() -> None:
+    """Run all tests in sequence."""
+    print("\n====== Starting All eClass MCP Server Tests ======\n")
+    
+    test_results['login'] = await test_login()
+    
+    if test_results['login']:
+        test_results['authstatus_after_login'] = await test_authstatus()
+        test_results['get_courses'] = await test_get_courses()
+        test_results['logout'] = await test_logout()
+    
+    test_results['authstatus_after_logout'] = await test_authstatus()
+    
+    print("\n====== Test Results Summary ======")
+    for test_name, result in test_results.items():
+        status = "PASSED" if result else "FAILED"
+        print(f"{test_name}: {status}")
+    
+    if all(test_results.values()):
+        print("\nAll tests PASSED!")
+    else:
+        print("\nSome tests FAILED!")
+    
+    print("\n====== Completed All eClass MCP Server Tests ======\n")
+
+
+if __name__ == "__main__":
+    asyncio.run(run_all_tests())

eclass_mcp_server/test/test_courses.py

@@ -0,0 +1,92 @@
+"""Test course retrieval functionality for eClass MCP Server."""
+
+import asyncio
+import logging
+import os
+import sys
+
+from dotenv import load_dotenv
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '../..')))
+from eclass_mcp_server.server import handle_get_courses, handle_login, session_state
+
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger('test_courses')
+
+
+async def ensure_login() -> bool:
+    """Ensure logged in before testing course retrieval."""
+    if session_state.logged_in and session_state.is_session_valid():
+        print("Already logged in, proceeding with tests.")
+        return True
+    
+    print("Not logged in, attempting login...")
+    
+    load_dotenv()
+    
+    username = os.getenv('ECLASS_USERNAME')
+    password = os.getenv('ECLASS_PASSWORD')
+    
+    if not username or not password:
+        print("ERROR: ECLASS_USERNAME and ECLASS_PASSWORD must be set in the .env file.")
+        return False
+    
+    response = await handle_login()
+    
+    if response and "Login successful" in response[0].text:
+        print("Login successful, proceeding with tests.")
+        return True
+    
+    print("Login failed, cannot proceed with course tests.")
+    return False
+
+
+async def test_get_courses() -> bool:
+    """Test the course retrieval functionality."""
+    print("Testing course retrieval functionality...")
+    
+    response = await handle_get_courses()
+    
+    if not response:
+        print("ERROR: Empty response from get_courses handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Course retrieval response: {text_content.text}")
+    
+    if "Error" in text_content.text:
+        print("Course retrieval test FAILED!")
+        return False
+    
+    if "No courses found" in text_content.text:
+        print("No courses found, but API worked correctly.")
+        print("Course retrieval test SUCCESS!")
+        return True
+    
+    if "Found" in text_content.text and "courses" in text_content.text:
+        if "URL:" in text_content.text:
+            print("Course retrieval test SUCCESS!")
+            return True
+        print("Course retrieval test FAILED! Output format is incorrect (missing URLs).")
+        return False
+    
+    print("Unexpected response from course retrieval.")
+    print("Course retrieval test FAILED!")
+    return False
+
+
+async def main() -> None:
+    """Run course tests."""
+    print("=== Starting eClass MCP Server Course Tests ===")
+    
+    if await ensure_login():
+        await test_get_courses()
+    
+    print("=== Completed eClass MCP Server Course Tests ===")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

eclass_mcp_server/test/test_login.py

@@ -0,0 +1,87 @@
+"""Test login functionality for eClass MCP Server."""
+
+import asyncio
+import logging
+import os
+import sys
+
+from dotenv import load_dotenv
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '../..')))
+from eclass_mcp_server.server import handle_login, handle_logout, session_state
+
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger('test_login')
+
+
+async def test_login() -> bool:
+    """Test the login functionality."""
+    print("Testing login functionality...")
+    
+    load_dotenv()
+    
+    username = os.getenv('ECLASS_USERNAME')
+    password = os.getenv('ECLASS_PASSWORD')
+    
+    if not username or not password:
+        print("ERROR: ECLASS_USERNAME and ECLASS_PASSWORD must be set in the .env file.")
+        return False
+    
+    response = await handle_login()
+    
+    if not response:
+        print("ERROR: Empty response from login handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Login response: {text_content.text}")
+    
+    if "Login successful" in text_content.text:
+        print("Login test SUCCESS!")
+        return True
+    
+    print("Login test FAILED!")
+    return False
+
+
+async def test_logout() -> bool:
+    """Test the logout functionality."""
+    if not session_state.logged_in:
+        print("Not logged in, skipping logout test.")
+        return False
+    
+    print("Testing logout functionality...")
+    
+    response = await handle_logout()
+    
+    if not response:
+        print("ERROR: Empty response from logout handler.")
+        return False
+    
+    text_content = response[0]
+    print(f"Logout response: {text_content.text}")
+    
+    if "Successfully logged out" in text_content.text:
+        print("Logout test SUCCESS!")
+        return True
+    
+    print("Logout test FAILED!")
+    return False
+
+
+async def main() -> None:
+    """Run login tests."""
+    print("=== Starting eClass MCP Server Login Tests ===")
+    
+    login_success = await test_login()
+    if login_success:
+        await test_logout()
+    
+    print("=== Completed eClass MCP Server Login Tests ===")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/METADATA

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_sdi2200262-eclass-mcp-server
+Version: 0.1.0
+Summary: An MCP server for the Open eClass platform by GUnet
+Author-email: CobuterMan <haidemenoss@gmail.com>
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: mcp>=1.24.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: requests>=2.32.0
+Description-Content-Type: text/markdown
+
+# eClass MCP Server
+
+An MCP server for interacting with the [Open eClass](https://github.com/gunet/openeclass) platform, with support for UoA's SSO authentication.
+
+<p align="center">
+    <a href="https://github.com/modelcontextprotocol/python-sdk"><img src="https://img.shields.io/badge/MCP-Protocol-blue" alt="MCP Protocol"></a>
+    <a href="https://www.gnu.org/licenses/gpl-3.0"><img src="https://img.shields.io/badge/License-GPLv3-blue.svg" alt="License: GPL v3"></a>
+    <img src="https://img.shields.io/badge/Python-3.10%2B-blue" alt="Python: 3.10+">
+</p>
+
+<p align="center">
+    <img src="assets/example.png" alt="Example Usage" width="600">
+</p>
+
+## Features
+
+- **SSO Authentication**: Log in through UoA's CAS SSO system
+- **Course Retrieval**: Get list of enrolled courses
+- **Session Management**: Persistent sessions between tool calls
+- **Status Checking**: Verify authentication status
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Installation
+
+```bash
+git clone https://github.com/sdi2200262/eclass-mcp-server.git
+cd eclass-mcp-server
+uv sync --dev --all-extras
+```
+
+### Configuration
+
+Create a `.env` file (or copy `example.env`):
+
+```bash
+ECLASS_USERNAME=your_username
+ECLASS_PASSWORD=your_password
+```
+
+Optional settings:
+```bash
+ECLASS_URL=https://eclass.uoa.gr          # Default
+ECLASS_SSO_DOMAIN=sso.uoa.gr              # Default
+ECLASS_SSO_PROTOCOL=https                 # Default
+```
+
+### Running
+
+```bash
+# Using the entry point script
+python run_server.py
+
+# Or as a module
+python -m src.eclass_mcp_server.server
+```
+
+## MCP Client Configuration
+
+To use this MCP server with Claude Desktop, VS Code, Cursor, or any MCP-compatible client, configure your client to run:
+
+```bash
+python3 /absolute/path/to/eclass-mcp-server/run_server.py
+```
+
+Set the following environment variables in your client's MCP configuration:
+
+```json
+{
+  "env": {
+    "ECLASS_USERNAME": "your_username",
+    "ECLASS_PASSWORD": "your_password"
+  }
+}
+```
+
+**Optional environment variables:**
+- `ECLASS_URL` - OpenEclass instance URL (default: `https://eclass.uoa.gr`)
+- `ECLASS_SSO_DOMAIN` - SSO domain (default: `sso.uoa.gr`)
+- `ECLASS_SSO_PROTOCOL` - SSO protocol (default: `https`)
+
+Refer to your specific client's documentation for how to add MCP servers to your configuration.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `login` | Authenticate using credentials from `.env` |
+| `get_courses` | Retrieve enrolled courses (requires login) |
+| `logout` | End the current session |
+| `authstatus` | Check authentication status |
+
+All tools use a dummy `random_string` parameter (MCP protocol requirement).
+
+## Standalone Client
+
+For non-MCP usage, a standalone client is included:
+
+```bash
+python eclass_client.py
+```
+
+This demonstrates the core functionality without MCP integration. See [docs/architecture.md](docs/architecture.md) for details.
+
+## Documentation
+
+- [Architecture](docs/architecture.md) - System design and authentication flow
+- [Wire Protocol](docs/reference/wire-protocol.md) - JSON-RPC message formats
+- [Tools Reference](docs/reference/tools-reference.md) - Detailed tool documentation
+
+## Project Structure
+
+```
+eclass-mcp-server/
+├── run_server.py               # Entry point
+├── eclass_client.py            # Standalone client (non-MCP)
+├── src/eclass_mcp_server/      # Main package
+│   ├── server.py               # MCP server and tool handlers
+│   ├── authentication.py       # SSO authentication
+│   ├── course_management.py    # Course operations
+│   ├── html_parsing.py         # HTML parsing utilities
+│   └── test/                   # Test scripts
+└── docs/                       # Documentation
+```
+
+## Security
+
+- Credentials are stored locally in `.env` only
+- Never passed as tool parameters (preventing AI provider exposure)
+- Sessions maintained in-memory only
+- No cloud services or remote storage
+
+## License
+
+[GNU GPL v3.0](LICENSE) - This ensures transparency in credential handling.
+
+## Acknowledgments
+
+- [GUnet](https://github.com/gunet) for the [Open eClass platform](https://github.com/gunet/openeclass)
+- This project is an independent interface, not affiliated with GUnet

iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+eclass_mcp_server/__init__.py,sha256=dm04z7pStZAy-J_t3dpDxnoNzD0x0RV87GRqbkb3hPw,233
+eclass_mcp_server/authentication.py,sha256=8Ltuba4qG4yiblwK44OboZ8-6R4--E3HpRQ79KYxj_M,6903
+eclass_mcp_server/course_management.py,sha256=8eKkB55O3rJ58IKeycFQACXa0UkP9mh7UIOImMmpfTc,2517
+eclass_mcp_server/html_parsing.py,sha256=ztmiVWqG3Dz_UVhZcBOaGexrJNPPFRY3kSbvNBDu_UY,5303
+eclass_mcp_server/server.py,sha256=J_euIPOCgo5yml8EGRB4-uHXtnoFl7zzyVZOx7frOXc,8117
+eclass_mcp_server/test/__init__.py,sha256=6CWwwhfzisuSlkknsm8jKnhCPTkw68816RmL9EbiYUk,42
+eclass_mcp_server/test/run_all_tests.py,sha256=mT_fqSjhgEUmb1MAxPEi-ZyNwYTErxcRgRGVvM1C8_M,5354
+eclass_mcp_server/test/test_courses.py,sha256=AYv6Tt_ZE1XRbX73L8rYC53rTcNJcoR4b_5Mk7diQOc,2734
+eclass_mcp_server/test/test_login.py,sha256=3wRstWBLe7c5HInDk4wrz3jDBMXFu5hpbz3UAzwP2wo,2218
+iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/METADATA,sha256=iVXJ5fd1h19_iGOWMXOUTs_p6bBJH8C2-SNrxsEgHBA,4694
+iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=FVYwA1FQMTcR3NcwQECbhKwt6DsUd5ZbYte4YYbUf70,82
+iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=BOrRwhm7skCATXYP84QJwMnxb2_hEb61cn7XyrRAUQ4,33188
+iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/RECORD,,

iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_sdi2200262_eclass_mcp_server-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+iflow-mcp_sdi2200262-eclass-mcp-server = eclass_mcp_server:main