Google Classroom MCP 服务器

一个 MCP (模型上下文协议) 服务器，通过 Claude 和其他支持 MCP 协议的 AI 助手提供对 Google Classroom 数据的访问。

设置

先决条件

• Node.js (v16 或更高版本)
• 一个启用了 Google Classroom API 的 Google Cloud Platform 项目
• Google Classroom API 的 OAuth 2.0 客户端凭据

安装

1. 克隆此存储库
2. 安装依赖项:

npm install

3. 将您的 Google OAuth 客户端凭据放入项目根目录中名为 credentials.json 的文件中:

{
  "web": {
    "client_id": "YOUR_CLIENT_ID",
    "project_id": "YOUR_PROJECT_ID",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:3000/auth/google/callback"]
  }
}

4. 使用 Google 身份验证:

node index.js auth

这将启动一个浏览器窗口来完成 OAuth 流程，并将您的凭据保存到 tokens.json。

5. 通过更新 claude_desktop_config.json (通常在 %APPDATA%\Claude\ 中) 来配置 Claude 以使用此服务器:

{
  "mcpServers": {
    "class": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_DIRECTORY\\index.js"
      ]
    }
  }
}

用法

可用工具

该服务器提供了几个用于与 Google Classroom 交互的工具:

1. courses - 列出所有您的 Google Classroom 课程

使用 'courses' 工具来获取所有 Google Classroom 课程的列表

2. course-details - 获取有关特定课程的详细信息

使用带有 courseId 参数的 'course-details' 工具来获取特定课程的详细信息和公告

参数:

• courseId: 课程的 ID (可以从 courses 工具中获得)

3. assignments - 获取特定课程的作业

使用带有 courseId 参数的 'assignments' 工具来获取特定课程的作业和您的提交

参数:

• courseId: 课程的 ID (可以从 courses 工具中获得)

Claude 的示例提示

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 帐户已作为测试用户添加到 Google Cloud Console 中。

3. 检查 authenticateAndSaveCredentials 函数中的 OAuth 范围，以确保它们符合您的需求。

笔记

• 此服务器旨在与 Claude AI 或其他 MCP 兼容的助手一起使用。
• 所有 API 请求都是使用您经过身份验证的 Google 帐户发出的。
• 令牌刷新由服务器自动处理。
• 敏感凭据本地存储在 tokens.json 文件中。