README.md•3.53 kB
# 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. 環境変数を設定してリフレッシュトークンを取得します。
```bash
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の実行時にエラーが発生する場合は、以下のコマンドを実行してください。
```bash
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`に環境変数を追加します：
```json
"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を表示