Imessage Query Fastmcp MCP Server

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

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

スコア : 2.5ポイント

ダウンロード数 : 55

更新時間 : 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"
    ]
  }
}