Mac Messages MCPサーバー

「Mac Messages」MCPサーバーは何をするのか？

Mac Messages MCPサーバーは、macOS上のiMessageデータベースと安全に連携するためのMCP（Model Context Protocol）サーバーです。AIアシスタントやLLMがiMessageの会話をクエリ・分析・操作できるようにし、会話型AIと個人または組織のメッセージ履歴を橋渡しします。このサーバーは、堅牢な電話番号バリデーション、添付ファイル処理、連絡先管理、グループチャット対応、メッセージの送受信の両方をサポートするなどの機能を提供します。これらの機能を活用することで、開発者は高度なワークフローを構築したり、メッセージベースのタスクを自動化したり、豊富なメッセージデータを生産性ツールや他のAIアプリケーションに活用できます。

プロンプト一覧

リポジトリやドキュメントには明示的なプロンプトテンプレートは記載されていません。

リソース一覧

MCPが定義するリソース（LLM用のサーバー公開データ/コンテンツ）については、リポジトリに明示的な記載はありません。

ツール一覧

リポジトリやserver.pyファイルにも明示的なツール一覧はありません。iMessage会話のクエリ、電話番号バリデーション、添付ファイル処理、連絡先管理、グループチャット対応、メッセージ送受信などの機能はツールとして提供されている可能性がありますが、MCPツールとして明確に列挙はされていません。

このMCPサーバーのユースケース

• iMessageデータベースクエリ
  AIアシスタントが過去のiMessage会話を検索・分析でき、特定情報や傾向、やり取りパターンの発見を助けます。
• 添付ファイル・メディア処理
  メッセージの添付ファイル（画像、ファイル）を抽出し、AIモデルによる後処理や要約を容易にします。
• 連絡先とグループチャット分析
  連絡先やグループチャットの整理・管理・クエリを可能にし、より文脈を活かしたアシスタント機能をサポートします。
• メッセージ自動化ワークフロー
  プログラムからiMessageの送受信を実現し、通知Botやリマインダー、AIによるワークフロー自動化を可能にします。
• 電話番号のバリデーションと正規化
  連絡先操作時に電話番号を検証・正規化し、精度向上とコミュニケーションエラー削減に役立ちます。

セットアップ方法

Windsurf

1. システムにPythonとNode.jsがインストールされていることを確認します。
2. Windsurfの設定ファイル（通常はwindsurf.config.json）を見つけます。
3. mcpServersセクションに次のJSONスニペットを追加します:

   {
     "mac-messages-mcp": {
       "command": "mac-messages-mcp",
       "args": []
     }
   }
   

4. 設定ファイルを保存し、Windsurfを再起動します。
5. WindsurfダッシュボードでMCPサーバーが接続されていることを確認します。

Claude

1. PythonとNode.jsがインストールされていることを確認します。
2. Claudeの設定画面を開きます。
3. MCPサーバーセクションにMac Messages MCPサーバーを追加します:

   {
     "mac-messages-mcp": {
       "command": "mac-messages-mcp",
       "args": []
     }
   }
   

4. 保存してClaudeを再起動します。
5. MCPサーバーとの接続を確認します。

Cursor

1. PythonとNode.jsがインストールされていることを確認します。
2. Cursorアプリケーションの設定または設定ファイルを開きます。
3. MCPサーバー設定セクションに次を追加します:

   {
     "mac-messages-mcp": {
       "command": "mac-messages-mcp",
       "args": []
     }
   }
   

4. 保存してCursorを再起動します。
5. サーバーが利用可能で稼働していることを確認します。

Cline

1. PythonとNode.jsがインストールされていることを確認します。
2. Clineの設定ファイルにアクセスします。
3. MCPサーバー設定を追加します:

   {
     "mac-messages-mcp": {
       "command": "mac-messages-mcp",
       "args": []
     }
   }
   

4. 保存してClineを再起動します。
5. Mac Messages MCPサーバーが接続されていることを確認します。

APIキーの安全な管理

機密性の高いキーやトークンは環境変数を利用して管理してください。設定ファイルでは次のように参照できます:

{
  "mac-messages-mcp": {
    "command": "mac-messages-mcp",
    "args": [],
    "env": {
      "IMESSAGE_DB_PATH": "/Users/youruser/Library/Messages/chat.db"
    },
    "inputs": {
      "api_key": "${IMESSAGE_API_KEY}"
    }
  }
}

IMESSAGE_DB_PATHやIMESSAGE_API_KEYは実際の環境変数名に置き換えてください。

フロー内でこのMCPを利用する方法

FlowHuntでのMCP利用

FlowHuntのワークフローにMCPサーバーを組み込むには、フローにMCPコンポーネントを追加し、AIエージェントと接続します。

MCPコンポーネントをクリックすると設定パネルが開きます。システムMCP設定セクションに次のJSON形式でMCPサーバー詳細を入力します:

{
  "mac-messages-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AIエージェントはこのMCPのすべての機能にアクセスできるようになります。"mac-messages-mcp"はMCPサーバーの実際の名称に、URLはご自身のMCPサーバーURLに変更してください。

概要

この表から、Mac Messages MCPサーバーはiMessageデータ連携に有用な橋渡しを提供していますが、MCPツールやリソース、プロンプト、エージェンティック・サンプリング/roots対応についての詳細なドキュメントは不足しています。主機能の使いやすさは高いものの、拡張性や標準化の観点では記載が限定的です。

MCPスコア