Google Form MCP Server

🚀 谷歌フォームとCamelAIOrgの統合プロジェクト

このプロジェクトは、Model Context Protocol（MCP）を通じて、谷歌フォームをCamelAIOrgのエージェントサービスと統合する方法を示しています。ユーザーは自然言語でフォーム作成のリクエストを送信でき、システム内部ではMCPプロトコルを使用してやり取りが行われます。

🚀 クイックスタート

このプロジェクトでは、自然言語でのフォーム作成リクエストを受け付け、MCPプロトコルを通じて谷歌フォームとCamelAIOrgのエージェントサービスを統合します。以下の手順に従って、プロジェクトをセットアップして使用してください。

✨ 主な機能

機能説明

1. ユーザーインターフェース
   • 自然言語でのリクエストを送信します（例：「3つの質問を含む顧客フィードバックフォームを作成して」）。
   • コンポーネント間のリクエストフローを確認できます。
   • 生成されたフォームの詳細情報とリンクを確認できます。
2. 内部通信
   • エージェントサービスが自然言語を解析し、MCPリクエストを生成します。
   • MCPサーバーがフォーム作成リクエストを処理し、谷歌APIと通信します。
   • リクエスト結果がMCPプロトコルを通じてエージェントサービスに返されます。
3. サポートシナリオ
   • 顧客フィードバック収集
   • 市場調査アンケート
   • イベントのRSVPフォーム
   • 任意のカスタム質問タイプ

📦 インストール

Dockerを使用した実行

docker-compose up --build

このコマンドは、MCPサーバー（ポート5000を監視）とエージェントサービス（ポート5001を監視）を起動します。

環境設定

プロジェクトのルートディレクトリに.envファイルを作成します。

# 谷歌APIの認証情報
GOOGLE_CLIENT_ID=あなたの_client_id
GOOGLE_CLIENT_SECRET=あなたの_client_secret
GOOGLE_REFRESH_TOKEN=あなたの_refresh_token

# サーバー設定
FLASK_ENV=development
PORT=5000
DEBUG=True

# CamelAIOrgエージェント設定
AGENT_ENDPOINT=http://agents:5001/process
AGENT_API_KEY=あなたのエージェントAPIキー

リフレッシュトークンを取得する手順：

1. OAuth 2.0 Playgroundツールを使用します：https://developers.google.com/oauthplayground/
2. プロジェクトの認証情報を設定します。
3. 必要な権限をフィルタリングします：
   • https://www.googleapis.com/auth/forms
   • https://www.googleapis.com/auth/drive
   • https://www.googleapis.com/auth/drive.file

💻 使用例

Webインターフェースへのアクセス

アクセスURL：http://localhost:5000 インターフェースの機能：

1. 自然言語でのリクエストを入力します。
2. コンポーネント間の通信フローを確認します。
3. 生成されたフォームの情報とリンクを確認します。
4. MCPプロトコルパケットの交換記録を確認します。

APIエンドポイントの説明

MCPサーバーエンドポイント（ポート5000）

• GET /api/health：ヘルスチェック
• GET /api/swagger：APIドキュメントを表示
• POST /api/create-form：新しいフォームを作成
  • JSON形式のリクエストボディをサポートします。例：

    {
      "form_name": "顧客フィードバックフォーム",
      "questions": [
        { "type": "テキスト", "prompt": "あなたの名前" },
        { "type": "メールアドレス", "prompt": "あなたのメールアドレス" }
      ]
    }
    

エージェントサービスエンドポイント（ポート5001）

• POST /process：自然言語リクエストを処理
  • HTTP POSTリクエストをサポートします。例：

    curl -X POST http://localhost:5001/process \
         -H "Content-Type: application/json" \
         -d '{"command": "フォームを作成", "details": {"question_count": 3}}'
    

📚 ドキュメント

プロジェクト構成

google-form-mcp-server/
├── server/                 # MCPサーバーの実装
│   ├── app.py              # メインのFlaskアプリケーション
│   ├── config.py           # 設定管理
│   ├── forms_api.py        # 谷歌フォームAPIの統合
│   ├── mcp_handler.py      # MCPプロトコルの処理ロジック
│   ├── requirements.txt    # Pythonの依存関係
│   ├── static/             # 静的リソースファイル
│   ├── templates/          # HTMLテンプレート
│   └── utils/              # ユーティリティ関数
├── agents/                 # CamelAIOrgエージェントサービス
│   ├── agent_integration.py # エージェントの統合実装
│   ├── agent_server.py     # エージェントAPIサーバー
│   └── requirements.txt    # Pythonの依存関係
├── Dockerfile              # MCPサーバーのDockerイメージ設定
├── docker-compose.yml      # マルチコンテナのデプロイ設定
├── .env.example            # 環境変数のサンプルファイル
└── README.md               # プロジェクトドキュメント

🔧 技術詳細

プロジェクトの依存関係

• Python 3.8以上
• Flaskフレームワーク
• google-authライブラリ
• requestsライブラリ

コントリビューションガイド

1. コードを提出する前に、コードをフォーマットしてください（black .）。
2. PRを提出する際には、ユニットテストを含めてください。
3. 既存の機能に不備がある場合は、Issuesに記載してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細な条項は、LICENSEファイルを参照してください。

謝辞

以下のプロジェクトのサポートに感謝します。

• Model Context Protocol（MCP）コミュニティ
• CamelAIOrg開発チーム
• 谷歌開発者サービス