Imessage Query Fastmcp MCP Server

FastMCPフレームワークに基づくiMessageクエリサーバーで、iMessageデータベースへの安全なアクセスと分析機能を提供します。

通信ツール開発者ツール #iMessageクエリ #データセキュリティ #MCPサービス .Python

スコア : 2.5ポイント

ダウンロード数 : 7.6K

更新時間 : 2025-04-29

サイトを開く

iMessageクエリMCPサーバーとは？

iMessageクエリMCPサーバーは、FastMCPフレームワークに基づいて構築されたツールで、macOS上のiMessageデータベースに安全にアクセスできます。メッセージテキスト、タイムスタンプ、添付ファイル情報、電話番号の有効性の検証を含む、iMessageの会話を簡単にクエリして分析できます。

iMessageクエリMCPサーバーの使い方は？

インストール後、簡単なコマンドでiMessageデータベースをクエリできます。たとえば、特定の連絡先のチャット履歴を取得したり、特定の日付範囲内のメッセージを表示したりできます。

適用シナリオ

このツールは、過去の会話内容を素早く振り返る必要がある人に最適です。たとえば、重要な情報を探したり、コミュニケーション記録を整理したり、過去の交流傾向を分析したりする場合に便利です。

主要機能

チャット履歴の取得

指定された電話番号に基づいて、完全なチャット履歴を取得し、日付でのフィルタリングをサポートします。

添付ファイルの処理

メッセージ内の添付ファイル情報を自動的に検出して処理し、データの完全性と安全性を確保します。

電話番号の検証

phonenumbersライブラリを使用して、入力された電話番号を厳密に検証し、正確性を確保します。

日付範囲のフィルタリング

ユーザーが開始日と終了日を設定でき、その期間内のメッセージのみを返します。

利点

iMessageデータベースへの読み取り専用アクセスで、データの安全性を保証します。

組み込みの電話番号検証機能で、誤入力のリスクを減らします。

複数のファイルタイプの添付ファイル処理をサポートし、互換性を向上させます。

簡潔で直感的なJSON形式の出力を提供し、後続の解析と使用を容易にします。

制限

macOSシステムのみをサポートします。

Python 3.6以上のインストールが必要です。

非常に大きなデータベースの場合、クエリに時間がかかることがあります。

使い方

リポジトリのクローン

ターミナルで以下のコマンドを実行して、プロジェクトコードをクローンします。 ```bash git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git ```

依存関係のインストール

プロジェクトディレクトリに移動した後、以下のコマンドを実行して必要な依存関係をインストールします。 ```bash pip install -r requirements.txt ```

サーバーの起動

インストールが完了したら、以下のコマンドを使用してMCPサーバーを起動します。 ```bash python3 imessage-query-server.py ```

クエリのテスト

以下のコマンドを実行して、正常に動作するかテストします。 ```bash get_chat_transcript +1234567890 ```

使用例

ケース1：直近1週間のチャット履歴のクエリ

ある友人との過去1週間の会話内容を確認したいとします。

ケース2：特定日の添付ファイルのエクスポート

ある日に送信されたすべてのファイルを収集する必要がある場合、以下の操作を実行できます。

よくある質問

iMessageクエリMCPサーバーはWindowsをサポートしていますか？

MCPサーバーをどのように更新しますか？

複数の連絡先のチャット履歴を一括でエクスポートできますか？

🚀 iMessageクエリMCPサーバ

このサーバは、モデルコンテキストプロトコル（MCP）を通じて、iMessageデータベースへの安全なアクセスを提供します。FastMCPフレームワークとimessagedbライブラリを使用して構築され、大規模言語モデル（LLMs）がiMessageの会話をクエリし分析することを可能にし、正しい電話番号検証と添付ファイル処理機能を備えています。

🚀 クイックスタート

このサーバを使用するためには、まずリポジトリをクローンします。

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
cd imessage-query-fastmcp-mcp-server

✨ 主な機能

大規模言語モデル（LLMs）がiMessageの会話をクエリし分析することを可能にする。
正しい電話番号検証と添付ファイル処理機能を備えている。
iMessageデータベースへの安全なアクセスを提供する。

📦 インストール

システム要件

macOS（iMessageデータベースへのアクセスに必要なシステム）
Python 3.6+

依存関係

すべての必要な依存関係をインストールします。

# pipを使用する
pip install -r requirements.txt

必要なパッケージ

fastmcp：MCPフレームワークを構築するためのライブラリ
imessagedb：macOS MessagesデータベースにアクセスしクエリするためのPythonライブラリ
phonenumbers：Googleの電話番号処理ライブラリで、正しい番号検証とフォーマットを行うために使用されます。

すべての依存関係はrequirements.txtファイルにリストされており、インストールが容易になっています。

インストールオプション

このMCPサーバは、Claude DesktopまたはCline VSCodeプラグインでインストールできます。あなたのニーズに最適なオプションを選択してください。

オプション1：Claude Desktop用にインストール

FastMCPを使用してインストールします。

fastmcp install imessage-query-server.py --name "iMessage クエリ"

オプション2：Cline VSCodeプラグイン用にインストール

このサーバをCline VSCodeプラグインと一緒に使用するには、以下の手順を実行します。

VSCodeで、Clineプラグインのサイドバーにあるサーバアイコン（☰）をクリックします。
「MCP設定を編集」ボタン（✎）をクリックします。
設定ファイルに以下の設定を追加します。

{
  "imessage-query": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "fastmcp",
      "run",
      "/path/to/repo/imessage-query-fastmcp-mcp-server/imessage-query-server.py"
    ]
  }
}