Google Classroom MCP 서버

Claude 및 MCP 프로토콜을 지원하는 다른 AI 도우미를 통해 Google Classroom 데이터에 대한 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다.

설정

필수 조건

• Node.js(v16 이상)
• Google Classroom API가 활성화된 Google Cloud Platform 프로젝트
• Google Classroom API에 대한 OAuth 2.0 클라이언트 자격 증명

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Google Classroom MCP 서버를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 이 저장소를 복제하세요
2. 종속성 설치:

3. Google OAuth 클라이언트 자격 증명을 프로젝트 루트의 credentials.json 이라는 파일에 저장합니다.

4. Google로 인증:

이렇게 하면 브라우저 창이 실행되어 OAuth 흐름을 완료하고 자격 증명을 tokens.json 에 저장합니다.

5. claude_desktop_config.json (일반적으로 %APPDATA%\Claude\ 에 있음)을 업데이트하여 Claude가 이 서버를 사용하도록 구성합니다.

용법

사용 가능한 도구

이 서버는 Google Classroom과 상호작용하기 위한 다양한 도구를 제공합니다.

1. courses - Google Classroom의 모든 과정을 나열하세요

2. course-details - 특정 과정에 대한 자세한 정보를 얻으세요

매개변수:

• courseId : 코스 ID( courses 도구에서 얻을 수 있음)

3. assignments - 특정 과목에 대한 과제를 받으세요

매개변수:

• courseId : 코스 ID( courses 도구에서 얻을 수 있음)

클로드에 대한 예시 프롬프트

1. 내 모든 Google Classroom 과정을 보여주세요
2. ID 123456789의 수학 과정에 대한 세부 정보를 받으세요
3. ID 987654321인 내 역사 과목의 모든 과제를 보여주세요.

권한

서버는 다음과 같은 Google Classroom API 권한을 요청합니다.

• classroom.courses.readonly - 과정 정보에 액세스하려면
• classroom.announcements.readonly - 수업 공지에 액세스하려면
• classroom.coursework.me.readonly - 과제 및 과제에 액세스하려면
• classroom.rosters.readonly - 학급 명단에 액세스하려면

문제 해결

권한 오류가 발생하면 다음을 시도해 보세요.

1. 권한을 새로 고치려면 auth 명령을 다시 실행합니다.
   node index.js auth
2. 앱이 테스트 모드인 경우 Google Cloud Console에서 Google 계정이 테스트 사용자로 추가되었는지 확인하세요.
3. authenticateAndSaveCredentials 함수에서 OAuth 범위를 확인하여 요구 사항과 일치하는지 확인합니다.

노트

• 이 서버는 Claude AI 또는 기타 MCP 호환 어시스턴트와 함께 사용하도록 설계되었습니다.
• 모든 API 요청은 인증된 Google 계정을 사용하여 이루어집니다.
• 토큰 새로 고침은 서버에서 자동으로 처리됩니다.
• 민감한 자격 증명은 tokens.json 파일에 로컬로 저장됩니다.