canvas-mcp-lite

Canvas LMS용으로 FastMCP로 구축된, 강사 중심의 경량 MCP 서버입니다. AI 어시스턴트가 Canvas 인스턴스에서 조교 역할을 수행할 수 있게 해줍니다: 과정 탐색, 학생 제출물 읽기(PDF/DOCX 파일 업로드 포함), 루브릭으로 채점, 공지 게시, 모듈 및 페이지 관리 등.

Tools

11개 Canvas 도메인에 걸친 64개 도구, 위험 수준별로 구성:

주요 기능:

• 학생이 실제로 제출한 내용 읽기 — get_submission_content는 업로드된 PDF, DOCX 파일 및 일반 텍스트(입력한 텍스트 항목, URL, 토론 제출물 포함)에서 텍스트를 추출하고 제출물 댓글 스레드를 포함하므로 채점 도구가 실제 콘텐츠를 기반으로 작동합니다.

• 실제 채점 워크플로 — list_ungraded_submissions는 채점 대기열이고, grade_submission은 점수, 합격/불합격, 문자 및 백분율 성적을 처리하며(Canvas가 댓글은 저장하지만 성적을 거부할 때 부분 성공을 보고), post_grades/hide_grades는 학생이 결과를 볼 시점을 제어합니다.

• 과정 코드 또는 ID — 모든 과정 범위 도구는 숫자 과정 ID 또는 course_code 문자열(짧은 TTL 캐시로 해석)을 허용합니다.

• 기본적으로 안전 — 달리 지정하지 않는 한 과제와 페이지는 비공개 상태로 생성되며, 파괴적인 도구는 명확하게 표시됩니다.

• LLM 친화적 출력 — 모든 도구는 원시 JSON 대신 형식화된 읽기 가능한 텍스트를 반환합니다.

Related MCP server: Canvas MCP

설정

Python 3.10+ 필요.

1. 설치 (프로젝트 루트에서 편집 가능 모드로):

   python -m venv .venv
   source .venv/bin/activate
   pip install -e .

2. 자격 증명 구성 — 패키지 옆의 .env 파일에:

   CANVAS_API_URL=https://yourschool.instructure.com/api/v1
   CANVAS_API_TOKEN=your-canvas-access-token

   Canvas의 Account → Settings → New Access Token에서 토큰을 생성하세요. .env는 작업 디렉터리가 아닌 패키지 위치를 기준으로 로드됩니다. MCP 클라이언트가 임의의 디렉터리에서 서버를 실행하기 때문입니다.

3. 실행 — 콘솔 스크립트로:

   canvas-mcp-lite

Claude와 함께 사용하기

stdio MCP 서버로 등록하세요. Claude Code의 경우:

claude mcp add canvas -- /path/to/.venv/bin/canvas-mcp-lite

또는 Claude Desktop / MCP 클라이언트 구성에서:

{
  "mcpServers": {
    "canvas": {
      "command": "/path/to/.venv/bin/canvas-mcp-lite"
    }
  }
}

프로젝트 구조

canvas_mcp_lite/
  server.py      FastMCP entry point; registers READ/WRITE/DELETE tool lists
  client.py      Async Canvas API client: auth, pagination, retry, errors
  util.py        Course code → ID resolution (cached), date formatting
  tools/         One module per domain: courses, assignments, grading,
                 modules_pages, announcements, discussions, files, quizzes,
                 messaging, peer_review, analytics

참고 사항

• 패키지 이름은 canvas_mcp_lite이며 상대 가져오기를 사용합니다 — python server.py가 아닌 설치된 canvas-mcp-lite 스크립트로 실행하세요.

• 텍스트 추출을 위한 파일 다운로드는 25MB로 제한됩니다. 스캔/이미지 전용 PDF는 텍스트 대신 알림을 반환합니다.

• Canvas API 오류는 상태 코드와 URL과 함께 표시됩니다. 일시적 시간 초과는 백오프로 재시도됩니다.