Google Classroom MCP 服务器

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

配置

先决条件

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

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Google Classroom MCP 服务器给 Claude Desktop：

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_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. 再次运行身份验证命令以刷新权限：

   node index.js auth
   

2. 如果您的应用程序处于测试模式，请确保您的 Google 账户已作为测试用户添加到 Google Cloud 控制台

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

注意事项

• 此服务器设计用于与 Claude AI 或其他兼容 MCP 的助手一起使用
• 所有 API 请求都使用您的已认证 Google 账户进行
• 令牌刷新由服务器自动处理
• 敏感凭据存储在本地的 tokens.json 文件中