Classroom Suite MCP

🎓 Classroom Suite MCP

Google Workspace の教育向けツールのための統合 MCP（Model Context Protocol）サーバーです。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. API とサービス > 認証情報 に移動します
2. 認証情報を作成 > OAuth クライアント ID をクリックします
3. アプリケーションの種類として デスクトップアプリ を選択します
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 - 詳細は LICENSE を参照してください。

🤝 貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。

📬 サポート

• 問題： GitHub Issues
• ディスカッション： GitHub Discussions

---

教育者と学生のために ❤️ を込めて作成