项目简介

iMessage 消息洞察 MCP 服务器 (iMessage Advanced Insights MCP Server) 是一款强大的后端应用，旨在深入分析您的 iMessage 对话数据，并以结构化的方式向 LLM 客户端（如 Claude Desktop）提供上下文信息和分析结果。它通过分析消息模式、情感倾向和社交网络连接，帮助用户更好地理解 iMessage 数据中蕴含的洞察。

主要功能点

联系人分析: 分析与特定联系人的消息模式和互动频率。
群聊分析: 洞察群聊动态、参与度和情感趋势。
社交网络分析: 发现基于共享群聊的联系人网络连接。
情感分析: 追踪对话中情感模式随时间的变化。
网络可视化: 生成社交网络的交互式可视化数据。
自然语言查询: 支持使用自然语言提问关于 iMessage 数据的问题。
增强联系人解析: 能够跨多种标识符类型（电话号码、邮件等）可靠地识别联系人。

安装步骤

克隆仓库

git clone https://github.com/rallyventurepartners/iMessage_MCPServer_AdvancedInsights.git
cd iMessage_MCPServer_AdvancedInsights

安装依赖

pip install -r requirements.txt

下载额外资源

python -m textblob.download_corpora
python -m spacy download en_core_web_sm

运行服务器
```
python main_async.py
```
服务器默认将在 'http://localhost:5000' 启动。

服务器配置

MCP 服务器主要服务于 MCP 客户端，例如 Claude Desktop。要将此服务器配置为 Claude Desktop 的 MCP 服务器，您需要将以下 JSON 配置导入到 Claude Desktop 的高级设置中。

Claude Desktop MCP 服务器配置 (JSON 格式):

{
  "mcpServers": {
    "iMessage Advanced Insights": {
      "command": "python3",  // 启动服务器的命令，这里假设您的 Python 3 可执行文件为 python3
      "args": [
        "main_async.py",    // 服务器主程序文件名
        "--port",           // 指定服务器端口的参数
        "5001"             // 服务器监听端口，可以根据需要修改，确保与Claude Desktop配置一致
      ]
    }
  }
}

配置参数说明:

'"iMessage Advanced Insights"': MCP 服务器的名称，在 Claude Desktop 中显示。
'"command": "python3"': 运行服务器的命令，请确保 Claude Desktop 环境可以执行 'python3' 命令。
'"args"': 传递给 'main_async.py' 脚本的命令行参数列表。
- '"main_async.py"': 指定执行 'main_async.py' 文件来启动服务器。
- '"–port"': 指定服务器监听的端口。
- '"5001"': 设置服务器监听端口为 5001。您可以根据需要修改此端口，但要确保与 Claude Desktop 中的配置一致，并且端口未被其他程序占用。

请注意:

请根据您的 Python 3 环境配置 '"command"' 字段，例如在某些系统中可能是 'python' 或 Python 3 的完整路径。
'"args"' 中的端口号 ('"5001"') 应该与您希望服务器运行的端口一致，并确保在 Claude Desktop 的 MCP 服务器配置中也使用相同的端口。

基本使用方法

启动服务器: 按照 "安装步骤" 中的指示启动 'iMessage 消息洞察 MCP 服务器'。
配置 Claude Desktop:
- 打开 Claude Desktop 的设置 (Settings)。
- 导航到 "高级设置" (Advanced Settings) 或类似部分。
- 找到 "MCP 服务器" (MCP Servers) 或 "自定义服务器" (Custom Servers) 设置。
- 导入或手动添加上面提供的 JSON 配置文件。
- 启用 "iMessage Advanced Insights" MCP 服务器。
在 Claude 中使用:
- 在 Claude Desktop 中开始或继续一个对话。
- 您现在可以向 Claude 提出关于您的 iMessage 数据的问题，例如：
  - "Who do I message with most frequently?" (我最常和谁发消息？)
  - "What's the sentiment analysis of my conversations with [contact]?" (我对和 [联系人] 的对话进行情感分析的结果是什么？)
  - "Show me my messaging patterns over time" (展示我的消息模式随时间的变化)
Claude 将会利用 iMessage 消息洞察 MCP 服务器来处理您的请求并提供分析结果。

命令行选项

服务器启动脚本 'main_async.py' 提供了一些命令行选项来自定义服务器行为，例如：

python main_async.py --help

常用的选项包括：

'--port <端口号>': 指定服务器监听的端口，默认为 '5000'。
'--db-path <数据库路径>': 自定义 iMessage 数据库 'chat.db' 文件的路径，默认为 '~/Library/Messages/chat.db'。
'--debug': 启用调试模式，提供更详细的日志输出。

您可以通过这些选项来调整服务器配置以满足您的具体需求。

关键词