Imessage Query Fastmcp MCP Server

🚀 iMessage 查詢 MCP 服務器

這是一個通過模型上下文協議（MCP）提供安全訪問的 iMessage 數據庫服務器。藉助 FastMCP 框架和 imessagedb 庫構建，它允許大語言模型（LLMs）查詢和分析 iMessage 對話，同時具備正確的電話號碼驗證和附件處理功能。

🚀 快速開始

克隆倉庫：

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

📦 安裝指南

系統要求

• macOS（iMessage 數據庫訪問所需的系統）
• Python 3.6+

依賴項

安裝所有必需的依賴項：

# 使用 pip
pip install -r requirements.txt

所需軟件包

• fastmcp：構建 MCP 框架的庫
• imessagedb：用於訪問和查詢 macOS Messages 數據庫的 Python 庫
• phonenumbers：Google 的電話號碼處理庫，用於正確的號碼驗證和格式化

所有依賴項均在requirements.txt文件中列出，以方便安裝。

安裝選項

您可以在 Claude Desktop 或 Cline VSCode 插件中安裝此 MCP 服務器。選擇最適合您需求的選項。

選項 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-fastmcp-mcp-server/imessage-query-server.py"
    ]
  }
}

將/path/to/repo替換為克隆倉庫的完整路徑（例如/Users/username/Projects/imessage-query-fastmcp-mcp-server）

✨ 主要特性

MCP 工具

服務器向 LLMs 公開以下工具：

get_chat_transcript

根據特定的電話號碼檢索消息歷史記錄，可選日期過濾。包括：

• 消息文本和時間戳
• 附件信息（如有）
• 正確的電話號碼驗證
• 日期範圍篩選

🔧 技術細節

安全功能

• iMessage 數據庫的只讀訪問
• 使用 phonenumbers 庫進行電話號碼驗證
• 附件處理的安全性，檢測缺失文件
• 日期範圍驗證
• 進度輸出抑制以保持 JSON 響應乾淨

📚 詳細文檔

倉庫包含用於開發的文檔：

• dev_docs/imessagedb-documentation.txt：包含 iMessage 數據庫結構和 imessagedb 庫功能的全面文檔。

該文檔在開發時作為上下文提供，並可用於與 LLMs 結合使用以輔助開發。