Imessage

🚀 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 賬戶發送。