imessage-query-fastmcp-mcp-server
このプロジェクトは、iMessageデータベースへの安全なアクセスを提供するMCPサーバーです。FastMCPフレームワークとimessagedbライブラリを使用して構築されており、電話番号の検証やmacOSの権限管理を自動化しています。これにより、LLMがiMessageの会話をクエリし、分析することが可能です。
GitHubスター
68
ユーザー評価
未評価
お気に入り
0
閲覧数
15
フォーク
13
イシュー
3
インストール方法
難易度
中級推定所要時間
10-20 分
必要な環境
macOSPython 3.12++1 more
インストール方法
インストール方法
前提条件
macOS: iMessageデータベースアクセスのために必要
Python 3.12以上: 現代的な型ヒントのために必要
uv: モダンなPythonパッケージマネージャ
フルディスクアクセス権限: MCPクライアント用（Claude Desktop、Cursor、VS Codeなど）
インストール手順
1. リポジトリのクローン
bash
git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
cd imessage-query-fastmcp-mcp-server
2. uvのインストール
bash
Homebrewを使用してuvをインストール（推奨）
brew install uv
または公式インストーラーを使用
curl -LsSf https://astral.sh/uv/install.sh | sh
トラブルシューティング
よくある問題
問題: サーバーが起動しない 解決策: Pythonのバージョンを確認し、依存関係が正しくインストールされているか確認してください。設定方法
設定方法
基本設定
Claude Desktop設定
~/.config/claude-desktop/claude_desktop_config.jsonを編集：
json
{
"mcpServers": {
"imessage-query": {
"command": "python",
"args": ["-m", "server"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}
環境変数
必要に応じて以下の環境変数を設定：bash
export API_KEY="your-api-key"
export DEBUG="true"
詳細設定
セキュリティ設定
APIキーは環境変数または安全な設定ファイルに保存
ファイルアクセス権限の適切な設定
ログレベルの調整
設定例
json
{
"mcpServers": {
"imessage-query": {
"command": "python",
"args": ["-m", "server"],
"env": {
"PORT": "3000",
"LOG_LEVEL": "info"
}
}
}
}
使用例
使用例
基本的な使用方法
プログラムでの使用
python
import requests
def call_mcp_tool(tool_name, params):
response = requests.post(
'http://localhost:3000/mcp/call',
json={
'tool': tool_name,
'parameters': params
}
)
return response.json()
使用例
result = call_mcp_tool('get_chat_transcript', {
'phone_number': '+1234567890',
'start_date': '2023-01-01',
'end_date': '2023-01-31'
})
print(result)
応用例
自動化スクリプト
bash
#!/bin/bash
バッチ処理の例
for file in *.txt; do
mcp-tool process "$file"
done
使用ケース
特定の電話番号に対するメッセージ履歴の取得
過去のiMessage会話の分析
特定の期間におけるメッセージの集計
LLMを用いたiMessageデータの自動処理