google-classroom-mcp-server

🚀 谷歌课堂 MCP 服务器

一个提供访问 Google Classroom 数据的 MCP（模型上下文协议）服务器，支持通过 Claude 和其他支持 MCP 协议的 AI 助手，让你能更便捷地与 Google Classroom 进行交互。

🚀 快速开始

本服务器可提供对 Google Classroom 数据的访问，支持通过 Claude 和其他支持 MCP 协议的 AI 助手使用。下面为你介绍具体的设置和使用方法。

✨ 主要特性

• 提供访问 Google Classroom 数据的功能。
• 支持通过 Claude 和其他支持 MCP 协议的 AI 助手。
• 提供多个与 Google Classroom 交互的工具。

📦 安装指南

先决条件

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

安装步骤

使用 Smithery 自动安装

通过 Smithery 自动为 Claude Desktop 安装 Google Classroom MCP Server：

npx -y @smithery/cli install @faizan45640/google-classroom-mcp-server --client claude

手动安装

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 使用此服务器，通过更新 %APPDATA%\Claude\ 中的 claude_desktop_config.json 文件：

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

💻 使用示例

基础用法

该服务器提供了与 Google Classroom 交互的多个工具：

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

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

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

使用 'course-details' 工具并提供 courseId 参数以获取特定课程的详细信息和公告

参数：

• courseId: 课程 ID（可从 courses 工具中获得）

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

使用 'assignments' 工具并提供 courseId 参数以获取特定课程的作业和你的提交

参数：

• courseId: 课程 ID（可从 courses 工具中获得）

示例提示 Claude

1. 显示我所有的 Google Classroom 课程
2. 获取 Math 课程（ID 123456789）的详细信息
3. 显示 Physics 课程作业的截止日期

🔧 技术细节

权限

• 读取所有课程：允许访问所有已创建或加入的课程。
• 写入权限：允许在课程中发布和管理内容。

示例

{
  "permissions": {
    "read": ["courses"],
    "write": ["courses"]
  }
}

故障排除

1. 确保你已正确配置环境变量。
2. 检查网络连接以确保能够访问 Google Classroom API。
3. 如果仍然遇到问题，请重新运行身份验证流程：

node index.js auth

这个 MCP 服务器为你提供了一个强大而灵活的工具，用于与 Google Classroom 进行交互。