iMessage 查询 MCP 服务器

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

📋 系统要求

• macOS（iMessage数据库访问所需的系统）
• Python 3.6+

📦 依赖项

安装所有必需的依赖项：

# 使用 pip
pip install -r requirements.txt

所需软件包

• fastmcp：构建MCP框架的库
• imessagedb：用于访问和查询macOS Messages数据库的Python库
• phonenumbers：Google的电话号码处理库，用于正确的号码验证和格式化

所有依赖项均在requirements.txt文件中列出，以方便安装。

📑 目录

• 系统要求
• 依赖项
• MCP 工具
• 快速入门指南
• 安装选项
  • Claude Desktop
  • Cline VSCode 插件
• 安全功能
• 开发文档
• 环境变量

🛠️ MCP 工具

服务器向LLMs公开以下工具：

get_chat_transcript

根据特定的电话号码检索消息历史记录，可选日期过滤。包括：

• 消息文本和时间戳
• 附件信息（如有）
• 正确的电话号码验证
• 日期范围筛选

🚀 快速入门指南

克隆仓库：

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

📦 安装选项

您可以在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）

🔒 安全功能

• iMessage数据库的只读访问
• 使用phonenumbers库进行电话号码验证
• 附件处理的安全性，检测缺失文件
• 日期范围验证
• 进度输出抑制以保持JSON响应干净

📚 开发文档

仓库包含用于开发的文档：

• dev_docs/imessagedb-documentation.txt：包含iMessage数据库结构和imessagedb库功能的全面文档。

该文档在开发时作为上下文提供，并可用于与LLMs结合使用以辅助开发。