iMessage 查询 MCP 服务器

一个 MCP 服务器，通过模型上下文协议 (MCP) 提供对 iMessage 数据库的安全访问。此服务器基于 FastMCP 框架和 imessagedb 库构建，使 LLM 能够查询和分析 iMessage 对话，并进行正确的电话号码验证和附件处理。

📋 系统要求

• macOS（访问 iMessage 数据库所必需）
• Python 3.6+

📦 依赖项

安装所有必需的依赖项：

# 使用 pip
pip install -r requirements.txt

必需的软件包

• fastmcp: 用于构建模型上下文协议服务器的框架
• imessagedb: 用于访问和查询 macOS Messages 数据库的 Python 库
• phonenumbers: Google 的电话号码处理库，用于正确的号码验证和格式化

所有依赖项都在 requirements.txt 中指定，以便于安装。

📑 目录

• 系统要求
• 依赖项
• MCP 工具
• 快速开始
• 安装选项
  • Claude Desktop
  • Cline VSCode 插件
• 安全特性
• 开发文档
• 环境变量

🛠️ MCP 工具

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

get_chat_transcript

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

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

🚀 快速开始

克隆存储库：

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

📦 安装选项

您可以将此 MCP 服务器安装在 Claude Desktop 或 Cline VSCode 插件中。选择最适合您需求的选项。

选项 1：为 Claude Desktop 安装

使用 FastMCP 安装：

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

选项 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-server.py"
    ]
  }
}

将 /path/to/repo 替换为您克隆此存储库的完整路径（例如，/Users/username/Projects/imessage-query-fastmcp-mcp-server）

🔒 安全特性

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

📚 开发文档

该存储库包含用于开发的文档文件：

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

此文档可用作开发功能时的上下文，并且可以与 LLM 一起使用以协助开发。

⚙️ 环境变量

不需要环境变量，因为服务器会自动在默认 macOS 位置找到 iMessage 数据库。