MCP Pa Ai Agent

🚀 MCP 個人アシスタントエージェント

このプロジェクトは、Model Context Protocol (MCP) を使用して構築された強力な個人アシスタント AI エージェントです。カレンダー管理、タスク管理、メール管理などの様々な機能を提供します。

🚀 クイックスタート

このプロジェクトは MCP プロトコルに基づくサーバーで、個人アシスタントエージェントを構築するための一連のツールを提供します。Claude for Desktop などの MCP クライアントと統合することで、AI アシスタントに以下の機能を付与します。

• カレンダーイベントの管理
• タスクと待办事項の追跡
• メールの閲覧と送信
• ウェブ検索と情報の取得
• スマートホームデバイスの制御

✨ 主な機能

• カレンダー管理：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 でデバイスの状態を取得できます。

📦 インストール

前提条件

⚠️ 重要提示

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 未満の場合、互換性のある環境を設定します。

# conda を使用する場合
conda create -n mcp-env python=3.10
conda activate mcp-env

# または venv を使用する場合（他の場所に Python 3.10+ がインストールされている場合）
python3.10 -m venv venv
source venv/bin/activate  # Windows の場合は venv\Scripts\activate

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

pip install -r requirements.txt

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

cp .env.example .env

6. .env ファイルを必要に応じて編集し、API の認証情報と設定を構成します。

💻 使用例

サーバーの起動

MCP サーバーを起動します。

python mcp_server.py

サーバーが起動し、MCP クライアントの接続を待機します。

Claude for Desktop への接続

1. Claude for Desktop をインストールします。
2. Claude for Desktop がこの MCP サーバーを使用するように設定し、設定ファイルを編集します。
   • 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 for Desktop を再起動します。