iMessage クエリ MCP サーバー

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

📋 システム要件

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

• Python 3.6以上

Related MCP server: imessage-mcp

📦 依存関係

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

# Using pip
pip install -r requirements.txt

必要なパッケージ

• fastmcp : モデルコンテキストプロトコルサーバーを構築するためのフレームワーク

• imessagedb : macOS メッセージデータベースにアクセスしてクエリを実行するための Python ライブラリ

• phonenumbers : 適切な番号検証とフォーマットのための Google の電話番号処理ライブラリ

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

📑 目次

• システム要件

• 依存関係

• MCPツール

• はじめる

• インストールオプション

  • クロードデスクトップ

  • Cline VSCode プラグイン

• 安全機能

• 開発ドキュメント

• 環境変数

🛠️ MCP ツール

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

チャットのトランスクリプトを取得する

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

• メッセージテキストとタイムスタンプ

• 添付ファイル情報（ある場合）

• 適切な電話番号の検証

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

🚀 はじめに

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

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. 「MCP設定の編集」ボタン（✎）をクリックします。

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 と組み合わせて使用することで開発を支援できます。

⚙️ 環境変数

サーバーは iMessage データベースをデフォルトの macOS の場所に自動的に見つけるので、環境変数は必要ありません。