iMessage Query MCP Server - Quick Start Guide

简介

这是一个 MCP 服务器，允许 LLMs 安全访问和查询您的 iMessage 数据库，基于 FastMCP 框架构建。

系统要求

• 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. 选择安装方式

   选项 1：Claude Desktop

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

   选项 2：Cline VSCode 插件

   • 在 VSCode 中打开 Cline 插件侧边栏
   • 点击"编辑 MCP 设置"
   • 添加以下配置：

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

   • 将 /path/to/repo 替换为实际路径

核心功能

get_chat_transcript 工具可以：

• 检索特定电话号码的消息历史
• 支持日期范围过滤
• 包含附件信息
• 处理电话号码验证

安全特性

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

更多资源

仓库中的 dev_docs 文件夹包含有关 iMessage 数据库结构和相关库功能的详细文档。