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 進行交互。