Personal Assistant MCP Server

by lemannrus
Verified

local-only server

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

Integrations

  • Create, read, update, and delete calendar events; list upcoming events

  • Create, read, update, and delete notes; perform full-text search; manage folders (create, delete, search, list)

  • Manage boards, lists, and cards; create, update, and delete cards; search cards by text query

パーソナルアシスタントMCPサーバー

Googleカレンダー、Obsidian Vault、Trello、ウェブページ解析機能など、様々なサービスと連携する強力なパーソナルアシスタントサーバーです。FastMCPを使用して構築されたこのサーバーは、デジタルライフを管理するための統合インターフェースを提供します。

特徴

  • Googleカレンダーとの統合
    • カレンダーイベントの作成、読み取り、更新、削除
    • 今後のイベントをリストする
  • Obsidian Vault 管理
    • メモの作成、閲覧、更新、削除
    • ノートの全文検索
    • フォルダ管理(作成、削除、検索、一覧表示)
  • Trelloとの統合
    • ボード、リスト、カードの管理
    • カードの作成、更新、削除
    • テキストクエリでカードを検索
  • ウェブページの解析
    • 任意の URL から HTML コンテンツを抽出してクリーンアップします

前提条件

  • Python 3.10以上
  • Poetry (Python パッケージ マネージャー)
  • Google カレンダー API 認証情報
  • Trello API 認証情報 (Trello 機能を使用する場合)
  • Obsidian Vault(Obsidian 機能を使用している場合)

インストール

  1. リポジトリをクローンします。
    git clone https://github.com/yourusername/personal-assistant-mcp.git cd personal-assistant-mcp
  2. Poetry を使用して依存関係をインストールします。
    poetry install
  3. Google カレンダー API を設定します。
    • Google Cloud Consoleにアクセスします
    • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
    • GoogleカレンダーAPIを有効にする
    • OAuth 2.0認証情報を作成する
    • 資格情報をダウンロードし、プロジェクトルートにcredentials.jsonとして保存します。
  4. Trello API を設定する (オプション):
    • Trello開発者ポータルへアクセス
    • APIキーとトークンを取得する
    • 環境変数または設定ファイルに追加します

構成

  1. Google カレンダーで認証するには、初期設定を実行します。
    poetry run python main.py
    • Google認証用のブラウザウィンドウが開きます
    • 指示に従ってアプリケーションを承認します

使用法

  1. サーバーを起動します。
    poetry run python main.py
  2. サーバーが起動し、MCP 互換のクライアント接続を受け入れる準備が整います。
  3. MCP互換クライアントを使用してサーバーとやり取りします。サーバーは以下のツールを提供します。
    • カレンダー管理
    • 黒曜石の金庫の操作
    • Trelloボード管理
    • ウェブページの解析

アントロピック・クロード・デスクトップ構成

このサーバーを Anthropic Claude Desktop で使用するには、Claude Desktop の設定に次の構成を追加します。

{ "mcpServers": { "personal-assistant": { "command": "/path/to/your/venv/bin/python", "args": ["/path/to/your/project/main.py"], "env": { "GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json", "GOOGLE_TOKEN_PATH": "/path/to/your/token.json", "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault", "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder", "LOG_PATH": "/path/to/log.txt", "TRELLO_TOKEN": "your_trello_token", "TRELLO_API_KEY": "your_trello_api_key" } } } }

パスと資格情報を実際の値に置き換えます。

  • command : Python仮想環境のPython実行ファイルへのパス
  • args : プロジェクトのmain.pyファイルへのパス
  • GOOGLE_CREDENTIALS_PATH : Google カレンダーの認証情報ファイルへのパス
  • GOOGLE_TOKEN_PATH : Google カレンダー トークン ファイルへのパス
  • OBSIDIAN_VAULT_PATH : Obsidian Vault へのパス
  • OBSIDIAN_DEFAULT_FOLDER : 新しいノートを作成するボールト内のデフォルトフォルダへのパス
  • TRELLO_TOKEN : Trello APIトークン
  • TRELLO_API_KEY : Trello APIキー

発達

  • このプロジェクトは依存関係の管理にPoetryを使用しています
  • すべてのツールはmain.pyに登録されています
  • サービス固有の実装はservices/ディレクトリにあります
  • PythonコードのPEP 8スタイルガイドラインに従う

貢献

  1. リポジトリをフォークする
  2. 機能ブランチを作成します( git checkout -b feature/amazing-feature
  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
  4. ブランチにプッシュする ( git push origin feature/amazing-feature )
  5. プルリクエストを開く

参加する:

テレグラムブログ

-
security - not tested
F
license - not found
-
quality - not tested

Google カレンダー、Obsidian Vault、Trello、Web ページ解析機能との統合を通じてデジタル ライフを管理するための統合インターフェース。

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Anthropic Claude Desktop Configuration
              1. Development
                1. Contributing
                  ID: rtwik9l6bl