iMessage Query MCP Server

iMessage Query MCP Server

一个通过模型上下文协议（MCP）提供安全访问您的iMessage数据库的MCP服务器。该服务器基于FastMCP框架和imessagedb库构建，使语言模型能够查询和分析iMessage对话，并具备正确的电话号码验证和附件处理功能。

GitHub
Created Byhannesrudolphhannesrudolph

📋 概述

这是一个基于 FastMCP 框架的 MCP 服务器，允许语言模型安全地查询和分析您的 iMessage 对话数据。

🔍 主要功能

  • 安全访问 macOS iMessage 数据库
  • 电话号码验证和格式化
  • 消息附件处理
  • 日期范围过滤

📦 系统要求

  • macOS 系统
  • Python 3.6+

🚀 快速开始

  1. 克隆仓库:

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

  2. 安装依赖:

    pip install -r requirements.txt

  3. 选择安装方式:

    对于 Claude Desktop:

    fastmcp install imessage-query-server.py --name "iMessage Query"

    对于 Cline VSCode 插件: 在 VSCode 的 Cline 设置中添加:

    {
  "imessage-query": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "fastmcp",
      "run",
      "/path/to/repo/imessage-query-server.py"
    ]
  }
}

🛠️ 使用方法

服务器提供 get_chat_transcript 工具，可以:

  • 检索指定电话号码的消息历史
  • 应用日期范围过滤
  • 获取消息文本、时间戳和附件信息

🔒 安全特性

  • 对 iMessage 数据库的只读访问
  • 电话号码验证
  • 安全的附件处理
  • 日期范围验证

📚 更多信息

开发文档位于 dev_docs/imessagedb-documentation.txt，其中包含关于 iMessage 数据库结构和库功能的详细信息。