iMessage MCP 服务器

⚠️ 免责声明 - 自行承担风险 ⚠️

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

这是一个使用AppleScript发送iMessages并管理联系人的MCP服务器。

该服务器通过Model Context Protocol (MCP)与macOS Messages和Contacts应用程序进行交互。它将AppleScript命令封装在一个TypeScript服务器中，允许您：

• 查看和搜索您的联系人
• 向联系人或电话号码发送iMessages
• 在消息发送时获取确认信息

功能

资源

• 通过contacts://all访问您的联系人
• 查看包括姓名、电话号码和电子邮件地址在内的联系人详情
• 所有数据都保留在您的本地机器上

工具

• search_contacts - 按姓名、电话或电子邮件查找联系人

  • 接受一个搜索查询，并返回匹配的联系人
  • 在姓名、电话号码和电子邮件地址之间进行搜索

• send_message - 发送iMessage

  • 接收收件人（电话/电子邮件）和消息内容
  • 通过您的本地Messages应用发送
  • 返回确认信息或错误详情

安装

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对话：

• "显示我的联系人"
• "搜索名为Marissa的联系人"
• "向555-0123发送一条消息说我会在10分钟后到那里"
• "给Alice发送一条iMessage询问我们是否仍然约定午餐"

安全注意事项

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

开发

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

npx @modelcontextprotocol/inspector node build/server.js

要求

• macOS（用于Messages和Contacts集成）
• Node.js 18或更高版本
• Claude Desktop
• 活跃的iMessage账户

故障排除

如果消息未发送：

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

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