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

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

概要

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

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

• タスクとToDoを追跡する

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

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

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

Related MCP server: Agentic Tools MCP Server

要件

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

• Python 3.10以上

• MCP SDK 1.2.0 以上

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

インストール

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

git clone https://github.com/yourusername/mcp-pa-ai-agent.git
cd mcp-pa-ai-agent

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

python --version

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

# Using conda
conda create -n mcp-env python=3.10
conda activate mcp-env

# OR using venv (if Python 3.10+ is installed elsewhere)
python3.10 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

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

pip install -r requirements.txt

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

cp .env.example .env

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

サーバーの実行

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

python mcp_server.py

サーバーが起動し、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. 次の構成を追加します。

{
  "mcpServers": {
    "personal-assistant": {
      "command": "/path/to/python",
      "args": [
        "/absolute/path/to/mcp-pa-ai-agent/mcp_server.py"
      ]
    }
  }
}

仮想環境を使用している場合は、その環境内の 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バージョンの問題

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

Error: Python 3.10 or higher is required for the MCP server.

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

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

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

ERROR: Could not find a version that satisfies the requirement mcp>=1.2.0

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

pip install --upgrade pip

発達

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

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

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

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

ライセンス

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

貢献

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