Google Forms MCP Server

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

ビルド方法

初期セットアップ

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

cd google-forms-server
npm install

サーバーのビルド

# メインのMCPサーバーをビルド
npm run build

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

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

開発環境における実行

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

# または、npm scriptを使用
npm run start

セットアップ方法

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

   • https://console.cloud.google.com/
   • APIとサービス > ライブラリから「Google Forms API」を検索して有効にします。

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

   • APIとサービス > 認証情報 > 認証情報を作成 > OAuth クライアントID
   • アプリケーションの種類：「デスクトップアプリ」を選択

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

   export GOOGLE_CLIENT_ID="あなたのクライアントID"
   export GOOGLE_CLIENT_SECRET="あなたのクライアントシークレット"
   cd google-forms-server
   npm run build
   node build/get-refresh-token.js

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

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

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

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

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

   "google-forms-server": {
     "command": "node",
     "args": [
       "/Users/nakamotomasatoshi/application/AI/mcp-google-form/google-forms-server/build/index.js"
     ],
     "env": {
       "GOOGLE_CLIENT_ID": "あなたのクライアントID",
       "GOOGLE_CLIENT_SECRET": "あなたのクライアントシークレット",
       "GOOGLE_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 - フォームの回答を取得します

使用例

フォームを作成して、いくつかの質問を追加してください。

Claudeは以下のようなMCPツールを使用してフォームを作成します：

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