Google Forms MCP

🚀 Google フォーム MCP サーバー

この MCP サーバーは、Google Forms API を使用して、フォームの作成、編集、回答の取得などの機能を提供します。

🚀 クイックスタート

📦 インストール

初期設定

リポジトリをクローンした後、依存関係をインストールします。

cd google-forms-mcp

サーバーのビルド

# 主要な MCP サーバーをビルド
npm run build

リフレッシュトークン取得スクリプトのビルド

# リフレッシュトークン取得スクリプトをビルド
npm run build:token

開発環境での実行

# サーバーを直接実行
node build/index.js

# または npm スクリプトを使用
npm run start

🔧 設定方法

1. Google Cloud Console でプロジェクトを作成し、Google Forms API を有効にします。

   • https://console.cloud.google.com/
   • APIs & Services > Library から "Google Forms API" を検索し、有効にします。

2. OAuth 2.0 クライアント ID とシークレットを取得します。

   • APIs & Services > Credentials > 認証情報の作成 > OAuth クライアント ID
   • アプリケーションの種類を "デスクトップアプリ" として選択します。

3. 環境変数を設定し、リフレッシュトークンを取得します。

   export GOOGLE_CLIENT_ID="YOUR_CLIENT_ID"
   export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET"
   cd google-forms-mcp
   npm run build
   node build/get-refresh-token.js
   

   ⚠️ 重要提示

   get-refresh-token.js を実行する際にエラーが発生した場合は、以下のコマンドを実行してください。

   cd google-forms-mcp
   npm run build:token
   node build/get-refresh-token.js
   

4. 表示されたリフレッシュトークンをコピーします。

5. Claude デスクトップアプリケーションの設定ファイルを更新します。

   • ~/Library/Application Support/Claude/claude_desktop_config.json を開きます。
   • mcpServers セクションの google-forms-mcp 内に環境変数を追加します。

   "google-forms-mcp": {
     "command": "node",
     "args": [
       "/path/to/your/google-forms-mcp/build/index.js" # このパスを更新
     ],
     "env": {
       "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID",
       "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
       "GOOGLE_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
     }
   }
   

6. Claude デスクトップアプリケーションを再起動します。

✨ 主な機能

この MCP サーバーは以下のツールを提供します。

1. create_form - 新しい Google フォームを作成
2. add_text_question - フォームにテキスト質問を追加
3. add_multiple_choice_question - フォームに複数選択質問を追加
4. get_form - フォームの詳細情報を取得
5. get_form_responses - フォームの回答を取得