moodle-mcp

Claude에게 Moodle에 대한 전체 액세스 권한(코스, 파일, 과제, 성적, 퀴즈, 캘린더 등)을 부여하세요. 한 번의 명령으로 강의 노트에서 Obsidian 학습 보관소를 구축할 수 있습니다.

13개 도구 · 5개 프롬프트 · MCP 리소스

빠른 시작

1. 설치

npx moodle-mcp

또는 전역으로 설치:

npm install -g moodle-mcp

2. 토큰 가져오기 → 아래 참조

3. MCP 클라이언트에 추가

Claude Desktop (Mac의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows의 경우 %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "moodle": {
      "command": "npx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://moodle.yourschool.edu",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

VS Code (.vscode/mcp.json에 추가):

{
  "servers": {
    "moodle": {
      "command": "npx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://moodle.yourschool.edu",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

토큰 가져오기

옵션 A — Moodle 프로필 페이지 (어디서나 작동)

1. 브라우저에서 학교 Moodle에 로그인합니다.

2. 프로필 → 보안 키(URL: https://moodle.yourschool.edu/user/managetoken.php)로 이동합니다.

3. Moodle 모바일 웹 서비스 토큰을 찾아 복사합니다.

4. MCP 설정에서 MOODLE_TOKEN=<token>을 설정합니다.

옵션 B — 사용자 이름 + 비밀번호 (SSO를 사용하지 않는 학교)

학교에서 일반 사용자 이름/비밀번호(Microsoft/Google/SSO 아님)를 사용하는 경우 토큰 단계를 완전히 건너뛸 수 있습니다:

"env": {
  "MOODLE_URL": "https://moodle.yourschool.edu",
  "MOODLE_USERNAME": "your_username",
  "MOODLE_PASSWORD": "your_password"
}

⚠️ SSO 학교: 학교 로그인 페이지가 Microsoft, Google 또는 다른 ID 공급자로 리디렉션되는 경우 옵션 B는 작동하지 않습니다. 옵션 A 또는 C를 사용하세요.

옵션 C — Moodle 모바일 앱에서 추출 (SSO 학교)

1. 휴대폰에 Moodle 앱을 설치하고 SSO로 로그인합니다.

2. 앱 설정 → 정보로 이동합니다.

3. 버전 번호를 5번 탭하여 개발자 모드를 활성화합니다.

4. 개발자 옵션 → 토큰 복사로 이동하여 복사합니다.

5. 해당 토큰을 옵션 A의 MOODLE_TOKEN으로 사용합니다.

도구

프롬프트

프롬프트를 지원하는 모든 MCP 클라이언트(Claude Desktop, Copilot이 포함된 VS Code 등)에서 사용하세요:

Obsidian 기말고사 준비

한 번의 명령으로 전체 학기를 연결된 지식 그래프로 바꾸세요.

설정

1. Obsidian 설치(무료, Mac/Windows/Linux 지원)

2. 새 보관소 생성(예: ~/obsidian/finals)

3. moodle-mcp가 MCP 클라이언트에 연결되어 있는지 확인

보관소 구축

Claude Desktop에서 /build-study-notes 프롬프트를 사용하세요:

/build-study-notes courseId=42 vaultPath=~/obsidian/finals

또는 Claude에 직접 붙여넣으세요:

Pull my [Course Name] (course ID 42), read all the lecture notes and slides,
and build a linked Obsidian vault at ~/obsidian/finals — one note per topic,
with [[wikilinks]] between related concepts, a MOC.md index, and tags for each section.

Claude는 다음을 수행합니다:

1. 모든 코스 섹션, 파일, 과제 및 성적을 가져옵니다.

2. MCP 리소스 프로토콜을 통해 각 PDF 및 문서를 직접 읽습니다.

3. 핵심 개념, 정의 및 예제가 포함된 섹션당 하나의 .md 파일을 작성합니다.

4. 노트 전반에 걸쳐 관련 용어 사이에 [[wikilinks]]를 추가합니다.

5. 모든 것을 연결하는 MOC.md(콘텐츠 맵) 인덱스를 생성합니다.

그래프 보기

1. Obsidian에서 보관소를 엽니다.

2. 그래프 보기(사이드바 아이콘 또는 Cmd+G)를 클릭합니다.

3. 전체 코스가 지식 그래프로 나타납니다. 연결된 개념은 함께 클러스터링되고, 고립된 주제는 검토해야 할 항목으로 눈에 띕니다.

자연어 검색

보관소가 구축되면 Claude에게 특정 콘텐츠를 찾도록 요청할 수 있습니다:

/search-notes courseId=42 query="the central limit theorem and when to use it"

Claude는 모든 코스 자료를 살펴보고, 관련 파일을 찾아 읽고, 직접적인 답변을 종합합니다.

호환성

일부 도구는 Moodle 관리자가 특정 웹 서비스를 활성화해야 합니다. moodle_get_site_info를 실행하여 학교 Moodle에서 사용할 수 있는 도구를 확인하세요.

도구를 사용할 수 없는 경우, 관리자가 무엇을 활성화해야 하는지 설명하는 유용한 메시지가 반환되며 서버가 중단되지 않습니다.

기여

이슈 및 PR을 환영합니다. 큰 변경 사항은 먼저 이슈를 열어주세요.

MIT 라이선스 — © 2026 Alexandre Ribeiro