Google Forms MCP Server

Google Forms MCP サーバー

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

ビルド方法

初期設定

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

cd google-forms-mcp

サーバーのビルド

# Build the main MCP server
npm run build

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

# Build the refresh token acquisition script
npm run build:token

開発環境での実行

# Run the server directly
node build/index.js

# Or, use npm script
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 > Create Credentials > OAuth client ID
   • Application type として「Desktop app」を選択します。

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" # Update this path
     ],
     "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 - フォームの回答を取得します

使用例

Create a form and add some questions.

Claude は、次のような MCP ツールを使用してフォームを作成します。

1. create_form ツールを使用して新しいフォームを作成します
2. add_text_question または add_multiple_choice_question ツールを使用して質問を追加します
3. 作成したフォームの URL を表示します