MCP Server Setup Instructions

MCP サーバーのセットアップ手順

この MCP サーバーは、Ionos AI モデルを使用して Gmail、Google Calendar、Google Tasks と連携できる Telegram AI エージェントを提供します。

前提条件

1. Python 3.8 以上
2. API が有効になっている Google Cloud プロジェクト
3. Telegram Bot トークン
4. Ionos AI API キー

ステップ 1：依存関係のインストール

pip install -r requirements.txt

ステップ 2：Google Cloud のセットアップ

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. 次の API を有効にします：
   • Gmail API
   • Google Calendar API
   • Google Tasks API
4. OAuth2 認証情報を作成します：
   • 「Credentials」→「Create Credentials」→「OAuth client ID」に移動します
   • 「Desktop application」を選択します
   • JSON ファイルをダウンロードし、credentials.json に名前を変更します
   • スクリプトと同じディレクトリに配置します

ステップ 3：Telegram Bot のセットアップ

1. Telegram で @BotFather にメッセージを送信します
2. /newbot コマンドを使って新しい bot を作成します
3. 手順に従って bot トークンを取得します
4. トークンを .env ファイルにコピーします

ステップ 4：Ionos AI のセットアップ

1. Ionos AI サービスから API キーを取得します
2. .env ファイルに追加します

ステップ 5：環境設定

1. .env.example を .env にコピーします
2. 必須項目をすべて入力します：

cp .env.example .env
# Edit .env with your actual values

ステップ 6：初回起動と認証

1. サーバーを初めて起動します：

python mcp_server.py

2. スクリプトから Google の認証を求められます：

   • URL が表示されます
   • ブラウザーで開きます
   • 権限を許可します
   • 認証コードをコピーしてターミナルに貼り付けます

3. 認証情報は、次回以降も使用できるよう token.pickle に保存されます

使用方法

利用可能なツール

1. send_telegram_message：Telegram 経由でメッセージを送信します
2. search_gmail：Gmail のメッセージを検索します
3. create_calendar_event：Google Calendar の予定を作成します
4. create_task：Google Tasks のタスクを作成します
5. ai_chat：Ionos AI モデルとチャットします

Telegram コマンド

• /start - bot を初期化します
• AI とチャットするには、任意のメッセージを送信します

対話例

Gmail を検索する：

"Search for emails from [email protected]"

カレンダーの予定を作成する：

"Create a meeting for tomorrow at 2 PM for 1 hour about project review"

タスクを作成する：

"Add a task to review the quarterly report by Friday"

ファイル構成

├── mcp_server.py          # Main MCP server
├── requirements.txt       # Python dependencies
├── .env                  # Environment variables
├── credentials.json      # Google OAuth2 credentials
├── token.pickle         # Saved Google authentication token
└── README.md            # This file

セキュリティに関する注意事項

1. .env ファイルを安全に保管し、バージョン管理に絶対にコミットしないでください
2. token.pickle ファイルには機密性の高い認証データが含まれています
3. 本番環境では HTTPS を使用してください
4. API キーを定期的にローテーションしてください

トラブルシューティング

よくある問題

1. 「ModuleNotFoundError」：すべての依存関係がインストールされていることを確認してください
2. 「Authentication failed」：Google の認証情報を確認し、認証を再実行してください
3. 「Telegram bot not responding」：bot トークンとネットワーク接続を確認してください
4. 「Ionos AI errors」：API キーとレート制限を確認してください

ログ

サーバーは重要なイベントをログに記録します。エラーメッセージやデバッグ情報は、コンソール出力を確認してください。

開発

機能を拡張するには：

1. setup_handlers() メソッドに新しいツールを追加します
2. 各ツールに対応するメソッドを実装します
3. 必要に応じてリソース一覧を更新します
4. デプロイ前に十分にテストします

本番環境へのデプロイ

本番環境で使用する場合：

1. systemd や supervisord などのプロセスマネージャーを使用します
2. 適切なログ記録を設定します
3. ファイアウォールルールを設定します
4. 環境ごとの設定を使用します
5. 監視とアラートを設定します

API のレート制限

API のレート制限に注意してください：

• Gmail API：1 日あたり 10 億クォータ単位
• Calendar API：1 日あたり 100 万リクエスト
• Tasks API：1 日あたり 50,000 リクエスト
• Ionos AI：プランの上限を確認してください

サポート

問題や質問がある場合：

1. エラーメッセージがないかログを確認します
2. すべての認証情報が正しいことを確認します
3. 各コンポーネントを個別にテストします
4. サービスの障害について、API のステータスページを確認します