edu-workspace-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 edu-workspace-mcp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# 🎓 edu-workspace-mcp
+
+자연어로 Google Docs, Sheets, Slides, Forms, Drive와 Classroom을 사용하는 교육 특화 Model Context Protocol(MCP) 서버입니다. Apps Script 없이 Google 공식 API를 직접 호출합니다.
+
+[공식 홈페이지](https://edu.jeld.kr/) · [개인정보처리방침](https://edu.jeld.kr/privacy.html) · [이용약관](https://edu.jeld.kr/terms.html)
+
+> 현재 버전은 로컬 stdio MCP 베타입니다. 공용 Google 데스크톱 OAuth 클라이언트가 포함되어 있어 최종 사용자가 Google Cloud 프로젝트를 만들 필요가 없습니다. 앱은 제품 전체 범위 대신 앱이 사용하는 파일에 한정된 `drive.file` 권한을 요청합니다.
+
+## 할 수 있는 일
+
+- 수업 자료용 Google Docs 문서 생성
+- 학생 명단·루브릭·성적표 형태의 Google Sheets 생성
+- 차시별 Google Slides 프레젠테이션 생성
+- 정답·배점이 포함된 Google Forms 퀴즈 생성
+- Google Drive 파일 검색, 폴더 생성, 승인 후 공유
+- 교사가 담당하는 Google Classroom 수업 조회
+- Classroom 과제 초안 생성, 사용자 승인 후 게시
+
+예시 요청:
+
+> “`소화와 순환` 단원의 5문항 퀴즈와 학습지, 6장짜리 수업 슬라이드를 만들고 `2학년 과학` 클래스룸에 금요일 오후 6시 마감 과제 초안으로 등록해줘.”
+
+## 실제 교육 활용 데모
+
+한 번의 자연어 요청으로 여러 Google 교육 도구를 연결할 수 있습니다.
+
+```text
+교사 요청
+  → Drive 수업 폴더 생성
+  → Docs 교사용 수업안·학생용 학습지 생성
+  → Slides 수업 자료 생성
+  → Forms 정답·배점 포함 퀴즈 생성
+  → Classroom 과제 초안 생성
+  → 교사가 대상·마감·첨부를 확인한 뒤 게시
+```
+
+대표 데모 프롬프트:
+
+> 5학년 과학 ‘소화와 순환’ 수업 패키지를 만들어줘. Drive에 전용 폴더를 만들고, 교사용 수업안과 학생용 학습지는 Docs로, 6장 수업 자료는 Slides로, 5문항 형성평가는 Forms 퀴즈로 만들어줘. ‘5학년 3반 과학’ Classroom에는 과제 초안까지만 만들고 게시 전에 나에게 확인받아줘.
+
+| 교육 업무 | 만들어지는 결과 | 사용하는 도구 |
+| --- | --- | --- |
+| 한 차시 수업 패키지 | 수업안, 학습지, 슬라이드, 퀴즈, Classroom 초안 | Drive + Docs + Slides + Forms + Classroom |
+| 과정중심평가 관리 | 평가입력·학생별현황·항목별현황 시트 | Sheets |
+| 수행평가 설계 | 4수준 루브릭 문서와 학생 자기평가지 | Docs + Forms |
+| 형성평가 배포 | 정답·배점이 있는 퀴즈와 과제 초안 | Forms + Classroom |
+| 학기 자료 정리 | 검색 결과와 교과·단원별 Drive 폴더 | Drive |
+| 동료 교사 협업 | 확인 절차를 거친 댓글·읽기·편집 권한 | Drive 공유 |
+
+- [교육자를 위한 실제 활용 예시와 복사 가능한 프롬프트](docs/EDUCATOR_USE_CASES.md)
+- [예제 모음과 추천 첫 데모](examples/README.md)
+- [실제로 실행되는 수업 패키지 통합 테스트](src/tests/education-demo.test.ts)
+
+> v0.1은 새 파일 생성과 Classroom 초안·게시 흐름에 집중합니다. 기존 문서의 부분 편집, Sheets 차트·드롭다운·조건부 서식, Forms 응답과 학생 제출물 분석은 아직 지원하지 않습니다. 자세한 지원 범위는 [활용 예시 문서](docs/EDUCATOR_USE_CASES.md#현재-버전에서-가능한-범위)를 확인하세요.
+
+## MCP 도구
+
+| 도구 | 동작 | 성격 |
+| --- | --- | --- |
+| `workspace_get_auth_status` | Google 연결 상태와 범위 확인 | 읽기 |
+| `classroom_list_courses` | 교사가 담당하는 활성 수업 조회 | 읽기 |
+| `drive_search_files` | 이름·유형·폴더로 Drive 검색 | 읽기 |
+| `drive_create_folder` | Drive 폴더 생성 | 생성 |
+| `docs_create_document` | Docs 문서 생성 | 생성 |
+| `sheets_create_workbook` | 여러 탭과 초기 데이터가 있는 Sheets 생성 | 생성 |
+| `slides_create_presentation` | 제목·본문 슬라이드 생성 | 생성 |
+| `forms_create_quiz` | 문항·정답·배점이 있는 퀴즈 생성 | 생성 |
+| `classroom_create_assignment_draft` | 학생에게 보이지 않는 과제 초안 생성 | 생성 |
+| `classroom_publish_assignment` | 승인된 과제 초안을 학생에게 게시 | 외부 변경 |
+| `drive_prepare_share` | 공유 대상·권한 승인 준비 | 승인 준비 |
+| `drive_share_file` | 승인된 Drive 권한 변경 | 외부 변경 |
+
+게시와 공유 도구에는 MCP 안전 메타데이터가 포함되어 있습니다. 승인 ID는 15분 동안 유효하고 한 번만 사용할 수 있습니다.
+
+## 요구 사항
+
+- Node.js 20 이상
+- MCP를 지원하는 데스크톱 클라이언트
+- Google 계정
+
+## 빠른 설치 — 최종 사용자
+
+정식 npm 배포 후 macOS, Windows, Linux에서 다음 두 단계만 진행합니다. Google Cloud Console 설정은 필요하지 않습니다.
+
+```bash
+npx -y edu-workspace-mcp setup
+npx -y edu-workspace-mcp login
+```
+
+브라우저에서 Google 로그인과 권한 승인을 마치고 MCP 클라이언트에 연결하면 됩니다. 학교 계정에서 기관 관리자가 제3자 앱을 차단한 경우에는 관리자에게 앱 허용을 요청해야 합니다.
+
+```bash
+npx -y edu-workspace-mcp doctor
+```
+
+Google 토큰은 `~/.edu-workspace-mcp/token.json`에 사용자 전용 권한으로 저장됩니다. 연결을 해제하려면 다음을 실행합니다.
+
+```bash
+npx -y edu-workspace-mcp disconnect
+```
+
+## MCP 클라이언트 연결
+
+Claude Desktop과 Cursor 계열 JSON 설정:
+
+```json
+{
+  "mcpServers": {
+    "edu-workspace": {
+      "command": "npx",
+      "args": ["-y", "edu-workspace-mcp"]
+    }
+  }
+}
+```
+
+Codex·ChatGPT Desktop 계열 TOML 설정:
+
+```toml
+[mcp_servers.edu_workspace]
+command = "npx"
+args = ["-y", "edu-workspace-mcp"]
+default_tools_approval_mode = "writes"
+```
+
+ChatGPT 웹은 사용자 컴퓨터의 stdio 프로세스를 실행하지 않습니다. 웹 지원은 향후 호스팅형 Streamable HTTP 서버로 제공할 계획입니다.
+
+## 소스에서 실행
+
+공개 저장소에는 설치형 앱용 공용 OAuth client ID가 포함되어 있습니다. 최종 사용자는 별도 Google Cloud 프로젝트나 `credentials.json` 없이 `login`만 실행합니다.
+
+```bash
+npm install
+npm run check
+npm test
+npm run test:mcp
+node dist/cli.js setup
+node dist/cli.js login
+```
+
+개발 중 MCP 설정에서는 `command`에 `node`, `args`에 프로젝트의 절대 경로인 `dist/cli.js`를 지정할 수 있습니다.
+
+## 보안 모델
+
+- 필요한 Google OAuth 범위만 요청합니다.
+- 사용자의 OAuth 액세스·갱신 토큰은 Git에 포함되지 않고 로컬 사용자 폴더에만 저장됩니다.
+- 설치형 앱은 비밀을 유지할 수 없는 공개 클라이언트이므로 배포용 데스크톱 client ID와 client secret은 앱에 포함됩니다.
+- 검색·조회 도구에는 `readOnlyHint`를 표시합니다.
+- Classroom 게시와 Drive 공유에는 `destructiveHint`를 표시합니다.
+- Classroom 과제는 먼저 `DRAFT`로 만들고 별도 게시 도구에서 일회성 승인을 검증합니다.
+- Drive 공유도 준비와 확정 단계를 분리합니다.
+- 실제 학생 데이터가 아닌 별도 테스트 수업에서 먼저 검증하세요.
+
+Google OAuth 브랜딩과 개인정보처리방침을 공개해야 하며, Google Workspace for Education 관리자가 제3자 앱을 허용해야 할 수 있습니다.
+
+요청 범위의 상세 설명은 [OAuth 범위 문서](docs/OAUTH_SCOPES.md), 공개 데이터 처리 방침은 [개인정보처리방침](https://edu.jeld.kr/privacy.html)을 참고하세요. 공개 배포를 위한 범위별 사용 사유와 데모 영상 시나리오는 [OAuth 검수 제출 가이드](docs/OAUTH_VERIFICATION_GUIDE.md)에 정리되어 있습니다.
+
+## 테스트
+
+```bash
+npm run check       # TypeScript 정적 검사
+npm test            # 단위·MCP 인메모리 통합 테스트
+npm run test:mcp    # 실제 stdio 프로세스 연결 테스트
+npm audit --omit=dev
+```
+
+Google API 실계정 테스트에는 별도 테스트 계정을 사용하세요. CI에서는 외부 계정을 사용하지 않고 Google API 어댑터를 주입한 계약 테스트를 실행합니다.
+
+## 개발 현황
+
+- [x] OAuth 로그인·토큰 저장·연결 해제
+- [x] Drive 검색·폴더 생성·승인 공유
+- [x] Docs·Sheets·Slides·Forms 생성
+- [x] Classroom 수업 조회·과제 초안·승인 게시
+- [x] macOS·Windows·Linux 공통 npm 실행 구조
+- [x] 단위·MCP 통합·stdio 스모크 테스트
+- [x] 실계정 OAuth·Classroom 조회·Sheets 생성 E2E 테스트
+- [ ] Google OAuth 공개 앱 검증
+- [ ] 호스팅형 Streamable HTTP MCP
+- [ ] Calendar·Gmail·Tasks 확장
+
+전체 제품 계획은 [docs/IMPLEMENTATION_PLAN.md](docs/IMPLEMENTATION_PLAN.md)를 참고하세요.
+
+## 라이선스
+
+[MIT](LICENSE)

package/dist/approvals/service.d.ts

@@ -0,0 +1,9 @@
+export type ApprovalRecord = {
+    id: string;
+    action: "classroom.publish" | "drive.share";
+    summary: Record<string, unknown>;
+    expiresAt: string;
+};
+export declare function createApproval(action: ApprovalRecord["action"], summary: Record<string, unknown>): ApprovalRecord;
+export declare function consumeApproval(id: string, action: ApprovalRecord["action"]): ApprovalRecord;
+export declare function resetApprovalsForTests(): void;

package/dist/approvals/service.js

@@ -0,0 +1,27 @@
+import { randomUUID } from "node:crypto";
+const approvals = new Map();
+export function createApproval(action, summary) {
+    const record = {
+        id: randomUUID(),
+        action,
+        summary,
+        expiresAt: new Date(Date.now() + 15 * 60_000).toISOString()
+    };
+    approvals.set(record.id, record);
+    return record;
+}
+export function consumeApproval(id, action) {
+    const record = approvals.get(id);
+    if (!record || record.action !== action)
+        throw new Error("승인 요청을 찾을 수 없거나 작업이 일치하지 않습니다.");
+    if (Date.parse(record.expiresAt) <= Date.now()) {
+        approvals.delete(id);
+        throw new Error("승인 요청이 만료되었습니다. 작업 초안을 다시 생성하세요.");
+    }
+    approvals.delete(id);
+    return record;
+}
+export function resetApprovalsForTests() {
+    approvals.clear();
+}
+//# sourceMappingURL=service.js.map

package/dist/approvals/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/approvals/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEpD,MAAM,UAAU,cAAc,CAAC,MAAgC,EAAE,OAAgC;IAC/F,MAAM,MAAM,GAAmB;QAC7B,EAAE,EAAE,UAAU,EAAE;QAChB,MAAM;QACN,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE;KAC5D,CAAC;IACF,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,MAAgC;IAC1E,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC3F,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/C,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

package/dist/auth/bundled-oauth-client.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Public desktop OAuth client used by the npm distribution.
+ *
+ * Google treats installed applications as unable to keep a client secret.
+ * Set these values once after creating the production Desktop OAuth client.
+ * Until then, developers can use credentials.json or environment variables.
+ */
+export declare const BUNDLED_GOOGLE_OAUTH_CLIENT: {
+    readonly clientId: "749884149912-4nl430614qdfm27clnqtj0imvvfr7j5g.apps.googleusercontent.com";
+    readonly clientSecret: "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";
+};

package/dist/auth/bundled-oauth-client.js

@@ -0,0 +1,12 @@
+/**
+ * Public desktop OAuth client used by the npm distribution.
+ *
+ * Google treats installed applications as unable to keep a client secret.
+ * Set these values once after creating the production Desktop OAuth client.
+ * Until then, developers can use credentials.json or environment variables.
+ */
+export const BUNDLED_GOOGLE_OAUTH_CLIENT = {
+    clientId: "749884149912-4nl430614qdfm27clnqtj0imvvfr7j5g.apps.googleusercontent.com",
+    clientSecret: "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"
+};
+//# sourceMappingURL=bundled-oauth-client.js.map

package/dist/auth/bundled-oauth-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-oauth-client.js","sourceRoot":"","sources":["../../src/auth/bundled-oauth-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,QAAQ,EAAE,0EAA0E;IACpF,YAAY,EAAE,qCAAqC;CAC3C,CAAC"}

package/dist/auth/google-auth.d.ts

@@ -0,0 +1,12 @@
+export type AuthStatus = {
+    authenticated: boolean;
+    oauthClientConfigured: boolean;
+    oauthClientSource: "environment" | "credentials_file" | "bundled" | "missing";
+    credentialsPath: string;
+    tokenPath: string;
+    grantedScopes: string[];
+    message: string;
+};
+export declare function getAuthStatus(): Promise<AuthStatus>;
+export declare function login(): Promise<AuthStatus>;
+export declare function getAuthorizedClient(): Promise<import("googleapis-common").OAuth2Client>;

package/dist/auth/google-auth.js

@@ -0,0 +1,145 @@
+import { createServer } from "node:http";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { google } from "googleapis";
+import { credentialsPath, GOOGLE_SCOPES, tokenPath } from "../config.js";
+import { BUNDLED_GOOGLE_OAUTH_CLIENT } from "./bundled-oauth-client.js";
+async function readJson(filePath) {
+    return JSON.parse(await readFile(filePath, "utf8"));
+}
+async function loadClientConfig() {
+    const environmentClientId = process.env.EDU_WORKSPACE_GOOGLE_CLIENT_ID?.trim();
+    if (environmentClientId) {
+        return {
+            source: "environment",
+            config: {
+                client_id: environmentClientId,
+                client_secret: process.env.EDU_WORKSPACE_GOOGLE_CLIENT_SECRET?.trim() ?? "",
+                redirect_uris: ["http://127.0.0.1"]
+            }
+        };
+    }
+    try {
+        const credentials = (await readJson(credentialsPath()));
+        const clientConfig = credentials.installed ?? credentials.web;
+        if (clientConfig)
+            return { config: clientConfig, source: "credentials_file" };
+    }
+    catch {
+        // Continue to the bundled public client.
+    }
+    if (BUNDLED_GOOGLE_OAUTH_CLIENT.clientId) {
+        return {
+            source: "bundled",
+            config: {
+                client_id: BUNDLED_GOOGLE_OAUTH_CLIENT.clientId,
+                client_secret: BUNDLED_GOOGLE_OAUTH_CLIENT.clientSecret,
+                redirect_uris: ["http://127.0.0.1"]
+            }
+        };
+    }
+    throw new Error("공용 Google OAuth 앱이 아직 구성되지 않았습니다. 개발자는 credentials.json 또는 EDU_WORKSPACE_GOOGLE_CLIENT_ID를 설정하세요.");
+}
+function createOAuthClient(config, redirectUri) {
+    return new google.auth.OAuth2(config.client_id, config.client_secret, redirectUri ?? config.redirect_uris[0]);
+}
+export async function getAuthStatus() {
+    const credentialFile = credentialsPath();
+    const tokenFile = tokenPath();
+    let oauthClientSource = "missing";
+    try {
+        oauthClientSource = (await loadClientConfig()).source;
+    }
+    catch {
+        // Report missing configuration below.
+    }
+    try {
+        if (oauthClientSource === "missing")
+            throw new Error("OAuth client missing");
+        const token = (await readJson(tokenFile));
+        return {
+            authenticated: true,
+            oauthClientConfigured: true,
+            oauthClientSource,
+            credentialsPath: credentialFile,
+            tokenPath: tokenFile,
+            grantedScopes: token.scope?.split(" ").filter(Boolean) ?? [],
+            message: "Google 계정이 연결되어 있습니다."
+        };
+    }
+    catch {
+        return {
+            authenticated: false,
+            oauthClientConfigured: oauthClientSource !== "missing",
+            oauthClientSource,
+            credentialsPath: credentialFile,
+            tokenPath: tokenFile,
+            grantedScopes: [],
+            message: oauthClientSource === "missing"
+                ? "공용 Google OAuth 앱이 아직 구성되지 않았습니다. 개발용 credentials.json 또는 환경 변수가 필요합니다."
+                : "Google 계정이 연결되지 않았습니다. edu-workspace-mcp login을 실행하세요."
+        };
+    }
+}
+export async function login() {
+    const credentialFile = credentialsPath();
+    const tokenFile = tokenPath();
+    const { config } = await loadClientConfig();
+    const callbackServer = createServer();
+    const authorizationCode = new Promise((resolve, reject) => {
+        callbackServer.once("request", (request, response) => {
+            const callbackUrl = new URL(request.url ?? "/", "http://127.0.0.1");
+            const error = callbackUrl.searchParams.get("error");
+            const code = callbackUrl.searchParams.get("code");
+            if (error || !code) {
+                response.writeHead(400, { "content-type": "text/html; charset=utf-8" });
+                response.end("Google 로그인을 완료하지 못했습니다. 터미널에서 다시 시도하세요.");
+                reject(new Error(error ? `Google OAuth 오류: ${error}` : "OAuth 콜백에 인증 코드가 없습니다."));
+                return;
+            }
+            response.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+            response.end("로그인이 완료되었습니다. 이 창을 닫고 터미널로 돌아가세요.");
+            resolve(code);
+        });
+    });
+    await new Promise((resolve, reject) => {
+        callbackServer.once("error", reject);
+        callbackServer.listen(0, "127.0.0.1", () => resolve());
+    });
+    const address = callbackServer.address();
+    if (!address || typeof address === "string") {
+        callbackServer.close();
+        throw new Error("OAuth 콜백 서버의 포트를 할당하지 못했습니다.");
+    }
+    const redirectUri = `http://127.0.0.1:${address.port}/oauth2callback`;
+    const client = createOAuthClient(config, redirectUri);
+    const authUrl = client.generateAuthUrl({
+        access_type: "offline",
+        prompt: "consent",
+        scope: [...GOOGLE_SCOPES]
+    });
+    console.log("브라우저에서 아래 URL을 열어 Google 로그인을 완료하세요:\n");
+    console.log(authUrl);
+    let code;
+    try {
+        code = await authorizationCode;
+    }
+    finally {
+        callbackServer.close();
+    }
+    const { tokens } = await client.getToken(code);
+    if (!tokens.refresh_token) {
+        throw new Error("갱신 토큰을 받지 못했습니다. Google 계정에서 기존 앱 권한을 해제한 뒤 다시 로그인하세요.");
+    }
+    await mkdir(path.dirname(tokenFile), { recursive: true });
+    await writeFile(tokenFile, JSON.stringify(tokens, null, 2), { mode: 0o600 });
+    return getAuthStatus();
+}
+export async function getAuthorizedClient() {
+    const tokenFile = tokenPath();
+    const { config } = await loadClientConfig();
+    const client = createOAuthClient(config);
+    client.setCredentials((await readJson(tokenFile)));
+    return client;
+}
+//# sourceMappingURL=google-auth.js.map

package/dist/auth/google-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-auth.js","sourceRoot":"","sources":["../../src/auth/google-auth.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { mkdir, rm } from "node:fs/promises";
+import { APP_DIRECTORY, credentialsPath, tokenPath } from "./config.js";
+import { getAuthStatus, getAuthorizedClient, login } from "./auth/google-auth.js";
+function printHelp() {
+    console.log(`
+edu-workspace-mcp
+
+명령어:
+  setup       초기 폴더와 MCP 설정 예시를 보여줍니다.
+  login       Google OAuth 로그인 후 토큰을 안전한 로컬 경로에 저장합니다.
+  doctor      OAuth 자격 증명·토큰 상태를 확인합니다.
+  disconnect  연결 해제 방법을 안내합니다.
+  serve       stdio MCP 서버를 시작합니다. 명령이 없을 때의 기본 동작입니다.
+`);
+}
+async function main() {
+    const command = process.argv[2] ?? "serve";
+    if (command === "serve") {
+        await import("./index.js");
+        return;
+    }
+    if (command === "setup") {
+        await mkdir(APP_DIRECTORY, { recursive: true });
+        const status = await getAuthStatus();
+        console.log(`\n설정 폴더: ${APP_DIRECTORY}`);
+        console.log(`OAuth 클라이언트: ${status.oauthClientConfigured ? `${status.oauthClientSource} 설정 사용` : "아직 구성되지 않음"}`);
+        console.log(`\nCodex/ChatGPT Desktop 예시:\n[mcp_servers.edu_workspace]\ncommand = "npx"\nargs = ["-y", "edu-workspace-mcp"]`);
+        console.log(`\nClaude Desktop/Cursor 예시:\n{\n  "mcpServers": {\n    "edu-workspace": {\n      "command": "npx",\n      "args": ["-y", "edu-workspace-mcp"]\n    }\n  }\n}`);
+        console.log(status.oauthClientConfigured
+            ? "\n`npx edu-workspace-mcp login`으로 Google 계정을 연결하세요."
+            : `\n공개 배포 전에는 배포자가 공용 OAuth 앱을 설정해야 합니다. 개발 중에는 ${credentialsPath()}에 credentials.json을 둘 수 있습니다.`);
+        return;
+    }
+    if (command === "login") {
+        const status = await login();
+        console.log(status.message);
+        console.log(`토큰 저장 위치: ${status.tokenPath}`);
+        return;
+    }
+    if (command === "doctor") {
+        const status = await getAuthStatus();
+        console.log(JSON.stringify(status, null, 2));
+        if (status.authenticated) {
+            const client = await getAuthorizedClient();
+            await client.getAccessToken();
+            console.log("Google OAuth 토큰 갱신: 정상");
+        }
+        return;
+    }
+    if (command === "disconnect") {
+        await rm(tokenPath(), { force: true });
+        console.log(`로컬 Google 토큰을 제거했습니다: ${tokenPath()}`);
+        console.log("Google 계정의 제3자 앱 액세스 페이지에서도 이 앱의 권한을 철회할 수 있습니다.");
+        return;
+    }
+    printHelp();
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export declare const APP_NAME = "edu-workspace-mcp";
+export declare const APP_DIRECTORY: string;
+export declare const DEFAULT_CREDENTIALS_PATH: string;
+export declare const DEFAULT_TOKEN_PATH: string;
+export declare const GOOGLE_SCOPES: readonly ["https://www.googleapis.com/auth/drive.file", "https://www.googleapis.com/auth/classroom.courses.readonly", "https://www.googleapis.com/auth/classroom.coursework.me"];
+export declare function credentialsPath(): string;
+export declare function tokenPath(): string;

package/dist/config.js

@@ -0,0 +1,18 @@
+import os from "node:os";
+import path from "node:path";
+export const APP_NAME = "edu-workspace-mcp";
+export const APP_DIRECTORY = path.join(os.homedir(), `.${APP_NAME}`);
+export const DEFAULT_CREDENTIALS_PATH = path.join(APP_DIRECTORY, "credentials.json");
+export const DEFAULT_TOKEN_PATH = path.join(APP_DIRECTORY, "token.json");
+export const GOOGLE_SCOPES = [
+    "https://www.googleapis.com/auth/drive.file",
+    "https://www.googleapis.com/auth/classroom.courses.readonly",
+    "https://www.googleapis.com/auth/classroom.coursework.me"
+];
+export function credentialsPath() {
+    return process.env.EDU_WORKSPACE_CREDENTIALS_PATH ?? DEFAULT_CREDENTIALS_PATH;
+}
+export function tokenPath() {
+    return process.env.EDU_WORKSPACE_TOKEN_PATH ?? DEFAULT_TOKEN_PATH;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,4CAA4C;IAC5C,4DAA4D;IAC5D,yDAAyD;CACjD,CAAC;AAEX,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,wBAAwB,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,kBAAkB,CAAC;AACpE,CAAC"}

package/dist/google/classroom.d.ts

@@ -0,0 +1,39 @@
+export type CourseSummary = {
+    id: string;
+    name: string;
+    section?: string;
+    state?: string;
+    alternateLink?: string;
+};
+export declare function listCourses(query?: string): Promise<CourseSummary[]>;
+export type AssignmentDraftInput = {
+    courseId: string;
+    title: string;
+    description?: string;
+    dueAt?: string;
+    maxPoints?: number;
+    materials?: Array<{
+        title: string;
+        url: string;
+    }>;
+};
+export declare function createAssignmentDraft(input: AssignmentDraftInput): Promise<{
+    courseId: string;
+    courseWorkId: string | null | undefined;
+    title: string | null | undefined;
+    state: string | null | undefined;
+    alternateLink: string | null | undefined;
+    dueDate: import("googleapis").classroom_v1.Schema$Date | undefined;
+    dueTime: import("googleapis").classroom_v1.Schema$TimeOfDay | undefined;
+    materials: {
+        title: string;
+        url: string;
+    }[];
+}>;
+export declare function publishAssignment(courseId: string, courseWorkId: string): Promise<{
+    courseId: string;
+    courseWorkId: string;
+    state: string | null | undefined;
+    title: string | null | undefined;
+    alternateLink: string | null | undefined;
+}>;