Hannesrudolph Imessage Query Fastmcp MCP Server

🚀 iMessage 查询 MCP サーバ

このサーバは、Model Context Protocol (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 の会話をクエリし分析できる。
• 正しい電話番号の検証と添付ファイルの処理機能を備えている。

📦 インストール

📋 システム要件

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

📦 依存関係

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

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

必須パッケージ

• fastmcp：Model Context Protocol サーバを構築するためのフレームワーク
• imessagedb：macOS のメッセージデータベースにアクセスしクエリするための 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 プラグイン でこのサーバを使用するには：

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）

💻 使用例

基本的な使用法

このサーバは、LLM に以下のツールを提供します：

get_chat_transcript

特定の電話番号のチャット履歴を取得します。日付フィルタリングがオプションで利用できます。以下を含みます：

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

🔧 技術詳細

🔒 セキュリティ機能

• iMessage データベースへの読み取り専用アクセス
• phonenumbers ライブラリを使用した電話番号の検証
• 添付ファイル処理のセキュリティ検査（欠落ファイルの検出）
• 日付範囲の検証
• JSON 応答をきれいに保つための進捗出力の抑制

📚 開発ドキュメント

リポジトリには開発用のドキュメントが含まれています：

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

このドキュメントは開発時にコンテキストとして使用され、LLM と組み合わせて開発を支援することができます。

⚙️ 環境変数

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