iMessage Query MCP Server

iMessage クエリ MCP サーバー

Model Context Protocol（MCP）を介して、iMessage データベースに安全にアクセスできる MCP サーバーです。このサーバーは FastMCP フレームワークと imessagedb ライブラリを使用して構築されており、適切な電話番号の検証と添付ファイルの処理を行いながら、LLM が iMessage の会話をクエリして分析できるようにします。

📋 システム要件

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

📦 依存関係

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

# Using pip
pip install -r requirements.txt

必須パッケージ

• fastmcp：Model Context Protocol サーバーを構築するためのフレームワーク
• imessagedb：macOS の Messages データベースにアクセスし、クエリを実行するための Python ライブラリ
• phonenumbers：電話番号を適切に検証、書式設定するための Google の電話番号処理ライブラリ

すべての依存関係は、簡単にインストールできるように requirements.txt で指定されています。

📑 目次

• システム要件
• 依存関係
• MCP ツール
• はじめに
• インストール方法
  • Claude Desktop
  • Cline VSCode プラグイン
• 安全機能
• 開発ドキュメント
• 環境変数

🛠️ MCP ツール

このサーバーは、LLM に次のツールを公開します。

get_chat_transcript

オプションの日付フィルタリングを指定して、特定の電話番号のメッセージ履歴を取得します。以下が含まれます。

• メッセージのテキストとタイムスタンプ
• 添付ファイル情報（ある場合）
• 適切な電話番号の検証
• 日付範囲によるフィルタリング

🚀 はじめに

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

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

📦 インストール方法

この MCP サーバーは、Claude Desktop または Cline VSCode プラグインにインストールできます。ニーズに最も合った方法を選択してください。

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

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

fastmcp install imessage-query-server.py --name "iMessage Query"

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

このサーバーを Cline VSCode プラグインで使用するには、次の手順に従います。

1. VSCode で、Cline プラグインのサイドバーにあるサーバーアイコン（☰）をクリックします
2. 「Edit MCP Settings」ボタン（✎）をクリックします
3. 次の設定を設定ファイルに追加します。

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

/path/to/repo を、このリポジトリをクローンした場所のフルパス（例：/Users/username/Projects/imessage-query-fastmcp-mcp-server）に置き換えます。

🔒 安全機能

• iMessage データベースへの読み取り専用アクセス
• phonenumbers ライブラリを使用した電話番号の検証
• ファイルの欠落を検出する安全な添付ファイル処理
• 日付範囲の検証
• クリーンな JSON レスポンスを生成するための進捗出力の抑制

📚 開発ドキュメント

リポジトリには、開発用のドキュメントファイルが含まれています。

• dev_docs/imessagedb-documentation.txt：iMessage データベースの構造と、imessagedb ライブラリの機能に関する包括的なドキュメントが記載されています。

このドキュメントは機能の開発時に背景情報として役立ち、LLM と併用して開発を支援できます。

⚙️ 環境変数

サーバーが macOS のデフォルトの場所にある iMessage データベースを自動的に検出するため、環境変数は必要ありません。