Python Apple MCP

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 ファイルを参照してください。