🚀 iMessage MCP 服务器

一款使用 AppleScript 发送 iMessage 和管理联系人的 MCP 服务器。该服务器借助模型上下文协议 (MCP)，通过 AppleScript 与 macOS 消息和联系人应用程序进行交互。它将 AppleScript 命令封装在 TypeScript 服务器中，能让您：

• 查看并搜索联系人。
• 向联系人或电话号码发送 iMessage。
• 在消息发送时获得确认。

🚀 快速开始

安装完成后，您可以自然地与 Claude Desktop 对话，例如：

• "显示我的联系人"
• "搜索名为 Marissa 的联系人"
• "向 555-0123 发送消息，说我会在 10 分钟内到达"
• "向 Alice 发送 iMessage，询问是否仍然安排午餐"

✨ 主要特性

资源

• 通过 contacts://all 访问您的联系人。
• 查看联系人详细信息，包括姓名、电话号码和电子邮件地址。
• 所有数据保留在您计算机的本地。

工具

• search_contacts - 根据名称、电话或电子邮件搜索联系人
  • 接受一个搜索查询并返回匹配的联系人。
  • 在姓名、电话号码和电子邮件地址中进行搜索。
• send_message - 发送 iMessage
  • 接受收件人（电话/电子邮件）和消息内容。
  • 通过您的本地消息应用程序发送。
  • 返回确认或错误详细信息。

📦 安装指南

1. 安装依赖项：

npm install

2. 构建服务器：

npm run build

3. 配置 Claude Desktop 使用该服务器： 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/path/to/imessage-server/build/server.js"]
    }
  }
}

4. 重新启动 Claude Desktop。
5. 授予权限，当提示时：
   • 联系人访问
   • 消息访问

🔧 技术细节

开发

用于开发和调试，使用 MCP 监视器：

npx @modelcontextprotocol/inspector node build/server.js

需求

• macOS（用于消息和联系人集成）
• Node.js 18 或更高版本
• Claude Desktop
• 激活的 iMessage 账户

故障排除

如果消息没有发送：

1. 检查消息应用程序是否已登录。
2. 验证权限是否已授予。
3. 查看 Claude Desktop 日志中的错误：

tail -f ~/Library/Logs/Claude/mcp*.log

📄 许可证

⚠️ 重要提示

本软件按现状提供，没有任何担保或保证，自行承担风险。

💡 使用建议

• 所有操作都在您的本地计算机上进行，不会将任何联系人或消息数据发送到外部服务器。
• 该服务器需要 macOS 权限以访问 Contacts 和 Messages，消息通过您的 iMessage 账户发送。