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

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

概要

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

カレンダーイベントを管理する
タスクとToDoを追跡する
メールを読んで送信する
ウェブを検索して情報を取得する
スマートホームデバイスを制御する

Related MCP server: Meeting BaaS MCP Server

要件

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

Python 3.10以上
MCP SDK 1.2.0 以上
必要な Python パッケージ (requirements.txt を参照)

インストール

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

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

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

python --version

システムの 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

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

pip install -r requirements.txt

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

cp .env.example .env

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

サーバーの実行

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

python mcp_server.py

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

Claude for Desktop への接続

デスクトップ版Claudeをインストールする
次の構成ファイルを編集して、この MCP サーバーを使用するように Claude for Desktop を構成します。
- MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
次の構成を追加します。

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

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

デスクトップ版の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

発達

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

modules/ディレクトリに新しいモジュールを作成する
@mcp.tool()デコレータを使用して関数を実装する
mcp_server.pyにモジュールをインポートします。

ライセンス

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

貢献

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

MCP Personal Assistant Agent