cau-eclass-mcp

# CAU e-Class MCP **비공식 중앙대학교 e-Class 도구 · 비상업적 사용만 허용 · 상업적 사용 금지** 중앙대학교 e-Class의 강좌·공지·과제·마감일을 조회하고, 자료·계획서 PDF·영상을 내려받는 로컬 MCP 서버입니다. FastMCP 4.1.4를 사용하며 MCP 클라이언트와 stdio로 통신합니다. ## 설치 Python 3.12 이상이 필요합니다. [uv](https://docs.astral.sh/uv/getting-started/installation/) 또는 pip으로 **0.3.0**을 설치할 수 있습니다. ### PyPI로 설치 ```sh # Chrome·Edge 등 로컬 Chromium CDP 사용 uv tool install --python 3.12 'cau-eclass-mcp[cdp]==0.3.0' # 설치 확인 eclass-mcp --version ``` Aside만 사용한다면 `uv tool install --python 3.12 cau-eclass-mcp==0.3.0`으로 설치합니다. [PyPI](https://pypi.org/project/cau-eclass-mcp/) · [GitHub Releases](https://github.com/givemethatsewon/cau-eclass-mcp/releases) ### uv 없이 pip으로 설치 가상환경을 만든 뒤 설치합니다. `python` 명령이 없다면 macOS/Linux에서는 `python3`, Windows에서는 `py`를 사용하세요. ```sh python -m venv .venv ``` macOS/Linux에서는 `source .venv/bin/activate`, Windows PowerShell에서는 `.venv\Scripts\Activate.ps1`로 활성화합니다. ```sh # Chrome·Edge 등 로컬 Chromium CDP 사용 python -m pip install "cau-eclass-mcp[cdp]==0.3.0" # 설치 확인과 MCP 설정 생성 python -m eclass_mcp.cli --version python -m eclass_mcp.cli --browser cdp config --client claude ``` Aside만 사용한다면 `python -m pip install "cau-eclass-mcp==0.3.0"`로 설치하고 `--browser aside`로 설정을 생성합니다. 이하의 `eclass-mcp` 명령은 `python -m eclass_mcp.cli`로 바꿔 실행해도 됩니다. 생성된 MCP 설정은 가상환경의 Python 절대 경로를 사용하므로 해당 가상환경을 삭제하거나 옮기지 마세요. ### 전달받은 wheel로 설치 저장소 checkout 없이 wheel 파일을 설치할 수 있습니다. 아래 경로는 전달받은 파일 위치로 바꿉니다. ```sh # Chrome·Edge 등 로컬 Chromium CDP 사용 uv tool install --python 3.12 --from /absolute/path/cau_eclass_mcp-0.3.0-py3-none-any.whl --with 'playwright>=1.60,<2' cau-eclass-mcp # 설치 확인 eclass-mcp --version ``` Aside만 사용하는 경우 설치 명령의 `--with 'playwright>=1.60,<2'`를 생략합니다. `eclass-mcp`가 PATH에 없다면 `uv tool update-shell`을 실행한 뒤 터미널을 다시 엽니다. ### 소스에서 실행 ```sh uv sync --frozen --extra cdp uv run eclass-mcp --help ``` 이하의 `eclass-mcp` 명령은 소스 실행 시 `uv run eclass-mcp`로 바꾸면 됩니다. 설치된 Chrome·Edge에 연결만 하므로 `playwright install`로 별도 브라우저를 받을 필요는 없습니다. ## 브라우저 선택과 로그인 | 방식 | …