local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides integration with Google API for calendar management and email functionality, allowing access to events, creating new events, reading and sending emails.
Enables smart home control through Home Assistant, providing capabilities to list devices, control them, and get detailed information about device states.

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 を参照)

インストール

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

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にモジュールをインポートします。

ライセンス

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

貢献

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

AI アシスタントによるカレンダーの管理、タスクの追跡、電子メールの処理、Web の検索、スマートホームデバイスの制御を可能にする多目的モデルコンテキストプロトコルサーバーです。

Related Resources

Reddit Discussion about this server

MCP Personal Assistant Agent