gogcli-mcp-classroom 2.0.0

package/manifest.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/dxt/main/dist/mcpb-manifest.schema.json",
+  "manifest_version": "0.3",
+  "name": "gogcli-mcp-classroom",
+  "display_name": "gogcli (Classroom)",
+  "version": "2.0.0",
+  "description": "Extended Google Classroom for Claude via gogcli — auth + full Classroom support (courses, rosters, coursework, submissions, announcements, topics, invitations)",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com",
+    "url": "https://github.com/chrischall"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrischall/gogcli-mcp"
+  },
+  "homepage": "https://github.com/chrischall/gogcli-mcp",
+  "support": "https://github.com/chrischall/gogcli-mcp/issues",
+  "license": "MIT",
+  "keywords": [
+    "google",
+    "classroom",
+    "education",
+    "gogcli",
+    "gog",
+    "courses",
+    "assignments",
+    "grading",
+    "students",
+    "teachers"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/dist/index.js"
+      ],
+      "env": {
+        "GOG_ACCOUNT": "${user_config.gog_account}",
+        "GOG_PATH": "${user_config.gog_path}"
+      }
+    }
+  },
+  "user_config": {
+    "gog_account": {
+      "type": "string",
+      "title": "Google Account",
+      "description": "Default Google account email (optional — uses gogcli's configured default if omitted)",
+      "required": false
+    },
+    "gog_path": {
+      "type": "string",
+      "title": "gog Executable Path",
+      "description": "Path to the gog executable (optional — defaults to 'gog' on your PATH)",
+      "required": false
+    }
+  },
+  "tools": [
+    {
+      "name": "gog_auth_add",
+      "description": "Authorize a Google account via browser-based OAuth"
+    },
+    {
+      "name": "gog_auth_list",
+      "description": "List all Google accounts stored in gogcli"
+    },
+    {
+      "name": "gog_auth_status",
+      "description": "Show gogcli auth configuration (keyring, credential files)"
+    },
+    {
+      "name": "gog_auth_services",
+      "description": "List Google services and OAuth scopes supported by gogcli"
+    },
+    {
+      "name": "gog_auth_run",
+      "description": "Run any gog auth subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_classroom_courses_list",
+      "description": "List Google Classroom courses"
+    },
+    {
+      "name": "gog_classroom_courses_get",
+      "description": "Get a single course by ID"
+    },
+    {
+      "name": "gog_classroom_courses_create",
+      "description": "Create a new course"
+    },
+    {
+      "name": "gog_classroom_courses_update",
+      "description": "Update an existing course"
+    },
+    {
+      "name": "gog_classroom_courses_delete",
+      "description": "Delete a course"
+    },
+    {
+      "name": "gog_classroom_courses_archive",
+      "description": "Archive a course"
+    },
+    {
+      "name": "gog_classroom_courses_unarchive",
+      "description": "Unarchive a course"
+    },
+    {
+      "name": "gog_classroom_students_list",
+      "description": "List students in a course"
+    },
+    {
+      "name": "gog_classroom_students_get",
+      "description": "Get a specific student"
+    },
+    {
+      "name": "gog_classroom_students_add",
+      "description": "Add a student to a course"
+    },
+    {
+      "name": "gog_classroom_students_remove",
+      "description": "Remove a student from a course"
+    },
+    {
+      "name": "gog_classroom_teachers_list",
+      "description": "List teachers in a course"
+    },
+    {
+      "name": "gog_classroom_teachers_get",
+      "description": "Get a specific teacher"
+    },
+    {
+      "name": "gog_classroom_teachers_add",
+      "description": "Add a teacher to a course"
+    },
+    {
+      "name": "gog_classroom_teachers_remove",
+      "description": "Remove a teacher from a course"
+    },
+    {
+      "name": "gog_classroom_roster",
+      "description": "List the full course roster (students and/or teachers)"
+    },
+    {
+      "name": "gog_classroom_coursework_list",
+      "description": "List coursework (assignments) for a course"
+    },
+    {
+      "name": "gog_classroom_coursework_get",
+      "description": "Get a single coursework item"
+    },
+    {
+      "name": "gog_classroom_coursework_create",
+      "description": "Create coursework (assignment/question)"
+    },
+    {
+      "name": "gog_classroom_coursework_update",
+      "description": "Update existing coursework"
+    },
+    {
+      "name": "gog_classroom_coursework_delete",
+      "description": "Delete coursework"
+    },
+    {
+      "name": "gog_classroom_submissions_list",
+      "description": "List student submissions for coursework"
+    },
+    {
+      "name": "gog_classroom_submissions_get",
+      "description": "Get a single submission"
+    },
+    {
+      "name": "gog_classroom_submissions_grade",
+      "description": "Grade a submission"
+    },
+    {
+      "name": "gog_classroom_submissions_return",
+      "description": "Return a graded submission"
+    },
+    {
+      "name": "gog_classroom_submissions_turn_in",
+      "description": "Turn in a submission (student action)"
+    },
+    {
+      "name": "gog_classroom_submissions_reclaim",
+      "description": "Reclaim a turned-in submission (student action)"
+    },
+    {
+      "name": "gog_classroom_announcements_list",
+      "description": "List announcements"
+    },
+    {
+      "name": "gog_classroom_announcements_get",
+      "description": "Get an announcement"
+    },
+    {
+      "name": "gog_classroom_announcements_create",
+      "description": "Create an announcement"
+    },
+    {
+      "name": "gog_classroom_announcements_update",
+      "description": "Update an announcement"
+    },
+    {
+      "name": "gog_classroom_announcements_delete",
+      "description": "Delete an announcement"
+    },
+    {
+      "name": "gog_classroom_topics_list",
+      "description": "List topics in a course"
+    },
+    {
+      "name": "gog_classroom_topics_get",
+      "description": "Get a topic"
+    },
+    {
+      "name": "gog_classroom_topics_create",
+      "description": "Create a topic"
+    },
+    {
+      "name": "gog_classroom_topics_update",
+      "description": "Rename a topic"
+    },
+    {
+      "name": "gog_classroom_topics_delete",
+      "description": "Delete a topic"
+    },
+    {
+      "name": "gog_classroom_invitations_list",
+      "description": "List classroom invitations"
+    },
+    {
+      "name": "gog_classroom_invitations_get",
+      "description": "Get an invitation"
+    },
+    {
+      "name": "gog_classroom_invitations_create",
+      "description": "Create an invitation"
+    },
+    {
+      "name": "gog_classroom_invitations_accept",
+      "description": "Accept an invitation"
+    },
+    {
+      "name": "gog_classroom_invitations_delete",
+      "description": "Delete (revoke) an invitation"
+    },
+    {
+      "name": "gog_classroom_profile_get",
+      "description": "Get a classroom user profile (omit userId for self)"
+    },
+    {
+      "name": "gog_classroom_run",
+      "description": "Run any gog classroom subcommand (escape hatch)"
+    }
+  ],
+  "compatibility": {
+    "platforms": [
+      "darwin",
+      "linux",
+      "win32"
+    ],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "gogcli-mcp-classroom",
+  "version": "2.0.0",
+  "description": "Extended Google Classroom MCP server via gogcli — auth + full Classroom support",
+  "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrischall/gogcli-mcp"
+  },
+  "type": "module",
+  "bin": {
+    "gogcli-mcp-classroom": "dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc --noEmit && npm run bundle",
+    "bundle": "node ../../scripts/bundle.js src/index.ts dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "google",
+    "gogcli",
+    "google-classroom",
+    "classroom",
+    "education"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer, registerAuthTools, registerClassroomTools } from '../../gogcli-mcp/src/lib.js';
+import { registerExtraClassroomTools } from './tools/classroom-extra.js';
+
+const server = createServer({ name: 'gogcli-classroom' });
+registerAuthTools(server);
+registerClassroomTools(server);
+registerExtraClassroomTools(server);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools/classroom-extra.ts

@@ -0,0 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+export function registerExtraClassroomTools(_server: McpServer): void {
+  /* no extras yet */
+}

package/tests/tools/classroom-extra.test.ts

@@ -0,0 +1,12 @@
+import { describe, it, expect, vi } from 'vitest';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerExtraClassroomTools } from '../../src/tools/classroom-extra.js';
+
+describe('registerExtraClassroomTools', () => {
+  it('registers no tools (no extras yet)', () => {
+    const server = new McpServer({ name: 'test', version: '0.0.0' });
+    const spy = vi.spyOn(server, 'registerTool');
+    registerExtraClassroomTools(server);
+    expect(spy).not.toHaveBeenCalled();
+  });
+});

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "../"
+  },
+  "include": ["src/**/*", "../gogcli-mcp/src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    coverage: {
+      provider: 'v8',
+      include: ['src/**/*.ts'],
+      exclude: ['src/index.ts'],
+      thresholds: {
+        lines: 100,
+        functions: 100,
+        branches: 100,
+        statements: 100,
+      },
+    },
+  },
+});