Classroom Suite MCP

🎓 Classroom Suite MCP

一个统一的 MCP（Model Context Protocol）服务，适用于 Google Workspace 教育工具，可将 Google Classroom、Google Drive 和 Google Docs 与 Claude 等 AI 助手无缝集成。

✨ 功能

服务	工具	说明
📚 Classroom	6	管理课程、作业和提交内容
📁 Drive	7	创建、上传、下载和分享文件
📝 Docs	4	创建、读取、编辑文档并导出为 PDF

共 17 个工具——满足教育自动化所需的一切！

🚀 安装

使用 uvx（推荐）

uvx classroom-suite-mcp

使用 pip

pip install classroom-suite-mcp

从源代码安装

git clone https://github.com/anasdevai/classroom-suite-mcp.git
cd classroom-suite-mcp
pip install -e .

🔐 Google Cloud 设置

使用此服务前，需要设置 Google Cloud 凭据：

1. 创建 Google Cloud 项目

1. 前往 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用以下 API：
   • Google Classroom API
   • Google Drive API
   • Google Docs API

2. 创建 OAuth 凭据

1. 前往 APIs & Services > Credentials
2. 点击 Create Credentials > OAuth client ID
3. 将 Desktop app 选为应用类型
4. 将凭据下载为 credentials.json

3. 配置服务

将 credentials.json 放在工作目录中，或设置路径：

export GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json

首次运行时，浏览器窗口会打开以进行 OAuth 身份验证。

⚙️ 配置

环境变量

变量	默认值	说明
GOOGLE_CREDENTIALS_PATH	credentials.json	OAuth 凭据文件的路径
GOOGLE_TOKEN_PATH	token.json	身份验证令牌的存储路径

Claude Desktop 配置

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "classroom-suite": {
      "command": "uvx",
      "args": ["classroom-suite-mcp"]
    }
  }
}

或者使用 pip 安装：

{
  "mcpServers": {
    "classroom-suite": {
      "command": "classroom-suite-mcp"
    }
  }
}

🛠️ 可用工具

Google Classroom（6 个工具）

工具	说明
list_courses	列出所有已选课程
get_course	获取课程详情
list_assignments	列出课程作业
get_assignment	获取作业详情
list_submissions	列出作业提交内容
submit_assignment	提交带附件的作业

Google Drive（7 个工具）

工具	说明
list_files	列出文件和文件夹
search_files	按名称或内容搜索
create_folder	创建新文件夹
upload_file	上传文件
download_file	下载文件
share_file	与用户或公开分享
delete_file	移至回收站或删除

Google Docs（4 个工具）

工具	说明
create_doc	创建新文档
read_doc	读取文档内容
update_doc	追加、前置插入或替换文本
export_pdf	导出为 PDF

📖 使用示例

使用 Claude

You: List my Google Classroom courses

Claude: I'll list your courses using the classroom-suite-mcp tools.
[Uses list_courses tool]

Here are your courses:
1. Introduction to Computer Science (ACTIVE)
2. Data Structures and Algorithms (ACTIVE)
...

常见工作流

检查作业并提交：

1. list_courses → Get course ID
2. list_assignments → Find pending assignment
3. create_doc → Create solution document
4. submit_assignment → Submit with Drive file

整理课程资料：

1. create_folder → Create organized folder
2. upload_file → Upload materials
3. share_file → Share with classmates

🧪 开发

本地运行

# Clone the repository
git clone https://github.com/anasdevai/classroom-suite-mcp.git
cd classroom-suite-mcp

# Install dependencies
pip install -e .

# Run with stdio transport (for MCP clients)
classroom-suite-mcp

# Run with HTTP transport (for testing)
classroom-suite-mcp --transport http --port 8000

使用 MCP Inspector 测试

npx @anthropic-ai/mcp-inspector classroom-suite-mcp

📄 许可证

MIT 许可证——详情请参阅 LICENSE。

🤝 参与贡献

欢迎贡献！请随时提交 Pull Request。

📬 支持

• 问题： GitHub Issues
• 讨论： GitHub Discussions

---

为教育工作者和学生倾心打造 ❤️