iMessage MCP 服务器使用说明

项目简介

iMessage MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，它使用 AppleScript 作为桥梁，连接 LLM 客户端（如 Claude Desktop）与 macOS 的 iMessage 和通讯录应用。通过此服务器，LLM 可以安全地访问本地联系人信息并发送 iMessage 消息，所有操作均在本地机器上完成。

主要功能点

访问联系人资源: 通过 'contacts://all' 资源 URI，LLM 可以获取本地通讯录中所有联系人的姓名、电话号码和电子邮件地址。
搜索联系人工具: 提供 'search_contacts' 工具，允许 LLM 根据姓名、电话或电子邮件地址搜索本地联系人。
发送 iMessage 消息工具: 提供 'send_message' 工具，允许 LLM 通过本地 iMessage 应用向指定联系人或电话号码发送消息。

安装步骤

安装依赖: 在终端中，进入仓库根目录 'imessage-mcp-server'，运行命令安装项目依赖：
```
npm install
```
构建服务器: 运行命令编译 TypeScript 代码，生成可执行的 JavaScript 服务器文件：
```
npm run build
```

配置 MCP 客户端: 以 Claude Desktop 为例，你需要编辑其配置文件 'claude_desktop_config.json'，添加 iMessage MCP 服务器的配置信息。该文件通常位于 '~/Library/Application Support/Claude/' 目录下（macOS）。

{
  "mcpServers": {
    "imessage": {  // 服务器名称，可以自定义，例如 "imessage"
      "command": "node", // 启动服务器的命令，这里使用 Node.js 运行时
      "args": ["/path/to/imessage-server/build/server.js"] // 命令参数，指向编译后的服务器脚本文件路径。请将 "/path/to/imessage-server" 替换为你的 iMessage-mcp-server 仓库的实际路径
    }
  }
}

重启 Claude Desktop: 重启 Claude Desktop 使配置生效。
授权访问权限: 首次运行时，macOS 系统会提示请求访问 “通讯录” 和 “信息” 应用的权限，请务必允许，否则服务器将无法正常工作。

基本使用方法

完成安装和配置后，你可以在 Claude Desktop 中使用自然语言指令来调用 iMessage MCP 服务器的功能，例如：

“显示我的联系人” (对应访问 'contacts://all' 资源)
“搜索名为 Marissa 的联系人” (对应调用 'search_contacts' 工具)
“给 555-0123 发送消息说我 10 分钟后到” (对应调用 'send_message' 工具)
“给 Alice 发送 iMessage 问问午饭还约吗” (对应调用 'send_message' 工具)

注意: 请确保你的 macOS 系统已登录 iMessage 账号，并且已授予 Claude Desktop (或任何 MCP 客户端) 以及 iMessage MCP 服务器访问 “通讯录” 和 “信息” 应用的权限。

关键词

iMessage MCP 服务器使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息