iMessage クエリ MCP サーバー
モデルコンテキストプロトコル(MCP)を介してiMessageデータベースへの安全なアクセスを提供するMCPサーバー。このサーバーはFastMCPフレームワークとimessagedbライブラリを使用して構築されており、LLMが適切な電話番号検証と添付ファイル処理を行いながらiMessageの会話をクエリおよび分析できるようにします。
📋 システム要件
- macOS(iMessage データベースへのアクセスに必要)
- Python 3.6以上
📦 依存関係
必要な依存関係をすべてインストールします。
必要なパッケージ
- fastmcp : モデルコンテキストプロトコルサーバーを構築するためのフレームワーク
- imessagedb : macOS メッセージデータベースにアクセスしてクエリを実行するための Python ライブラリ
- phonenumbers : 適切な番号検証とフォーマットのための Google の電話番号処理ライブラリ
すべての依存関係はrequirements.txt
に指定されており、簡単にインストールできます。
📑 目次
🛠️ MCP ツール
サーバーは、LLM に次のツールを公開します。
チャットのトランスクリプトを取得する
特定の電話番号のメッセージ履歴を、オプションの日付フィルタリングを使用して取得します。含まれるもの:
- メッセージテキストとタイムスタンプ
- 添付ファイル情報(ある場合)
- 適切な電話番号の検証
- 日付範囲フィルタリング
🚀 はじめに
リポジトリをクローンします。
📦 インストールオプション
このMCPサーバーは、Claude DesktopまたはCline VSCodeプラグインのいずれかにインストールできます。ニーズに最適なオプションをお選びください。
オプション1: Claude Desktop 用にインストール
FastMCP を使用してインストールします。
オプション2: Cline VSCodeプラグインをインストールする
このサーバーをCline VSCodeプラグインで使用するには:
- VSCodeで、Clineプラグインサイドバーのサーバーアイコン(☰)をクリックします。
- 「MCP設定の編集」ボタン(✎)をクリックします。
- 設定ファイルに次の構成を追加します。
/path/to/repo
このリポジトリをクローンした場所へのフルパスに置き換えます (例: /Users/username/Projects/imessage-query-fastmcp-mcp-server
)
🔒 安全機能
- iMessageデータベースへの読み取り専用アクセス
- phonenumbersライブラリを使用した電話番号検証
- 不足しているファイルの検出による安全な添付ファイルの処理
- 日付範囲の検証
- クリーンな JSON レスポンスの進行状況出力の抑制
📚 開発ドキュメント
リポジトリには開発用のドキュメント ファイルが含まれています。
dev_docs/imessagedb-documentation.txt
: iMessage データベース構造と imessagedb ライブラリの機能に関する包括的なドキュメントが含まれています。
このドキュメントは機能を開発する際のコンテキストとして機能し、LLM と組み合わせて使用することで開発を支援できます。
⚙️ 環境変数
サーバーは iMessage データベースをデフォルトの macOS の場所に自動的に見つけるので、環境変数は必要ありません。
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
MCP を介して iMessage データベースへの安全なアクセスを提供する MCP サーバー。これにより、LLM は適切な電話番号検証と添付ファイル処理を使用して iMessage の会話を照会および分析できるようになります。
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.Last updated -116JavaScript
- -securityAlicense-qualityA server for the Machine Chat Protocol (MCP) that provides a YAML-based configuration system for LLM applications, allowing users to define resources, tools, and prompts without writing code.Last updated -5PythonMIT License
- -securityFlicense-qualityAn MCP server that allows Claude and other LLMs to manage persistent memories across conversations through text file storage, enabling commands to add, search, delete and list memory entries.Last updated -2TypeScript
- -securityAlicense-qualityA macOS app that provides an MCP server to your Messages, Contacts, and moreLast updated -646Apache 2.0