iMessage MCP 服务器

⚠️ 免责声明 - 使用风险自负 ⚠️

本软件按原样提供，不提供任何担保或保证。

一个使用 AppleScript 发送 iMessage 和管理联系人的 MCP 服务器。

此服务器使用 AppleScript 通过模型上下文协议 (MCP) 与 macOS 上的“信息”和“通讯录”应用交互。它将 AppleScript 命令封装在一个 TypeScript 服务器中，允许您：

• 查看和搜索您的联系人
• 向联系人或电话号码发送 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. 出现提示时授予权限：

   • 通讯录访问权限
   • 信息访问权限

用法

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

• "Show me my contacts" (显示我的联系人)
• "Search for contacts named Marissa" (搜索名为 Marissa 的联系人)
• "Send a message to 555-0123 saying I'll be there in 10 minutes" (发送消息给 555-0123 说我 10 分钟后到)
• "Send Alice an iMessage asking if we're still on for lunch" (给 Alice 发送 iMessage 询问我们是否还一起吃午饭)

安全注意事项

• 所有操作都在您的本地计算机上进行
• 没有联系人或消息数据发送到外部服务器
• 该服务器需要 macOS 权限才能访问“通讯录”和“信息”
• 消息通过您的 iMessage 帐户发送

开发

对于开发和调试，请使用 MCP Inspector：

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