Google Classroom MCP 服务器

这是一个支持 MCP（Model Context Protocol）协议的服务器，通过 Claude 和其他支持 MCP 协议的人工智能助手提供对 Google Classroom 数据的访问。

设置

前提条件

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

安装

通过 Smithery 安装

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

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

手动安装

1. 克隆此仓库
2. 安装依赖项：

bash
npm install

1. 将您的 Google OAuth 客户端凭据放在项目根目录下的 credentials.json 文件中：

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"]
}
}

1. 使用 Google 进行身份验证：

bash
node index.js auth

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

1. 通过更新 claude_desktop_config.json（通常位于 %APPDATA%Claude）来配置 Claude 以使用此服务器：

json
{
"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 文件中