MCP パーソナルアシスタントエージェント

モデル コンテキスト プロトコル (MCP) を使用して構築された多目的パーソナル アシスタント AI エージェント。カレンダー、タスク、電子メールなどの管理に役立ちます。

概要

このプロジェクトは、パーソナルアシスタントエージェント向けのツールセットを提供するモデルコンテキストプロトコル（MCP）サーバーです。Claude for DesktopなどのMCPクライアントと統合することで、AIアシスタントに以下の機能を提供できます。

• カレンダーイベントを管理する

• タスクとToDoを追跡する

• メールを読んで送信する

• ウェブを検索して情報を取得する

• スマートホームデバイスを制御する

要件

⚠️重要: MCP SDK には Python 3.10 以降が必要です。サーバーはそれより前のバージョンの Python では動作しません。

• Python 3.10以上

• MCP SDK 1.2.0 以上

• 必要な Python パッケージ (requirements.txt を参照)

インストール

1. リポジトリをクローンします。

2. Python 3.10 以上がインストールされていることを確認してください。

3. システムの Python が 3.10 より古い場合は、互換性のある環境を設定してください。

4. 依存関係をインストールします:

5. サンプル ファイルをコピーして環境変数を設定します。

6. API の資格情報と設定を使用して.envファイルを編集します。

サーバーの実行

次のコマンドで MCP サーバーを起動します。

サーバーが起動し、MCP クライアント接続をリッスンします。

Claude for Desktop への接続

1. デスクトップ版Claudeをインストールする

2. 次の構成ファイルを編集して、この MCP サーバーを使用するように Claude for Desktop を構成します。

   • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 次の構成を追加します。

仮想環境を使用している場合は、その環境内の Python 実行可能ファイルを必ず指定してください。

4. デスクトップ版のClaudeを再起動

利用可能なツール

カレンダー

• get_events : 今後のカレンダーイベントを取得する

• create_event : 新しいカレンダーイベントをスケジュールする

タスク

• list_tasks : すべてのタスクを表示するか、ステータスでフィルタリングする

• add_task : 新しいタスクを作成する

• update_task_status : タスクを保留中、進行中、完了としてマークします

メール

• get_emails : 受信トレイから最近のメールを一覧表示する

• read_email : 特定のメールの全内容を表示する

• send_email : 新しいメールを作成して送信する

知識

• web_search : ウェブで情報を検索する

• get_weather : 現在の天気情報を取得する

• get_news : 最新のニュース記事を取得する

スマートホーム

• list_devices : すべてのスマートホームデバイスを表示

• control_device : スマートホームデバイス（照明、サーモスタットなど）を制御します

• get_device_state : デバイスの現在の状態に関する詳細情報を取得する

構成

サーバーは、さまざまなサービスにアクセスするためにさまざまな API キーと資格情報を必要とします。

• Google API : カレンダーとメール機能用（OAuth2 認証情報）

• 天気API :天気情報

• ニュースAPI ：ニュース検索用

• ホームアシスタント：スマートホームコントロール

設定可能なすべてのオプションについては、 .env.exampleファイルを参照してください。

トラブルシューティング

Pythonバージョンの問題

次のようなエラーが表示された場合:

Python バージョンをアップグレードするか、Python 3.10 以降の仮想環境を使用する必要があります。

MCP SDK のインストールに関する問題

MCP SDK のインストール中に問題が発生した場合:

Python 3.10 以降を使用しており、pip が更新されていることを確認してください。

発達

サーバーに新しい機能を追加するには、次の操作を行います。

1. modules/ディレクトリに新しいモジュールを作成する

2. @mcp.tool()デコレータを使用して関数を実装する

3. mcp_server.pyにモジュールをインポートします。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。