Python Apple MCP (モデルコンテキストプロトコル)

FastMCP を使用して、連絡先、メモ、メール、メッセージ、リマインダー、カレンダー、マップなどの macOS アプリケーションとのやり取りを処理するサーバーの Python 実装。

特徴

• AppleScript を通じて macOS ネイティブアプリケーションと対話する

• パフォーマンス向上のための非同期操作

• 包括的なエラー処理

• Pydantic モデルを使用した型安全なインターフェース

• 広範なテスト範囲

• 簡単に拡張できるモジュール設計

サポートされているアプリケーション

• 連絡先

• 注記

• 郵便

• メッセージ

• リマインダー

• カレンダー

• 地図

インストール

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

2. 仮想環境を作成します。

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

4. テストの依存関係をインストールします（オプション）：

使用法

基本的な例

個々のモジュールの使用

テスト

テスト スイートを実行します。

カバレッジ付きのテストを実行します。

特定のテスト ファイルを実行します。

APIドキュメント

連絡先モジュール

• find_contact(name: str) -> List[Contact] : 名前で連絡先を検索する

• get_all_contacts() -> List[Contact] : すべての連絡先を取得する

• create_contact(name: str, phones: List[str]) -> Contact : 新しい連絡先を作成する

ノートモジュール

• find_note(query: str) -> List[Note] : ノートを検索する

• create_note(title: str, body: str, folder_name: str) -> Note : 新しいノートを作成する

• get_all_notes() -> List[Note] : すべてのノートを取得する

メールモジュール

• send_email(to: str, subject: str, body: str) -> str : メールを送信する

• search_emails(query: str) -> List[Email] : メールを検索

• get_unread_mails() -> List[Email] : 未読メールを取得する

メッセージモジュール

• send_message(to: str, content: str) -> bool : iMessageを送信する

• read_messages(phone_number: str) -> List[Message] : メッセージを読む

• schedule_message(to: str, content: str, scheduled_time: str) -> Dict : メッセージをスケジュールする

リマインダーモジュール

• create_reminder(name: str, list_name: str, notes: str, due_date: str) -> Dict : リマインダーを作成する

• search_reminders(query: str) -> List[Dict] : リマインダーを検索

• get_all_reminders() -> List[Dict] : すべてのリマインダーを取得する

カレンダーモジュール

• create_event(title: str, start_date: str, end_date: str, location: str, notes: str) -> Dict : イベントを作成する

• search_events(query: str) -> List[Dict] : イベントを検索する

• get_events() -> List[Dict] : すべてのイベントを取得する

マップモジュール

• search_locations(query: str) -> List[Location] : 場所を検索する

• get_directions(from_address: str, to_address: str, transport_type: str) -> str : 道順を取得する

• save_location(name: str, address: str) -> Dict : 場所をお気に入りに保存する

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。