Imessage Kit MCP

iMessage套件MCP服务器

iMessage的MCP服务器——通过iMessage Kit读取、发送和自动对话。

特性

• 发送消息：向电话号码或电子邮件地址发送iMessage
• 读取消息：从对话中检索消息历史记录
• 列出对话：获取所有活动的iMessage对话
• 对话详细信息：获取有关特定对话的详细信息
• 双重运输：支持STDIO（本地）和HTTP（生产）传输

工具

imsg_send_message

向收件人发送iMessage。

输入：

• recipient （字符串，必填）：电话号码（例如“+1234567890”）或电子邮件地址
• text （字符串，必填）：要发送的消息文本
• chatId （字符串，可选）：继续现有对话时的聊天ID

imsg_read_messages

从iMessage对话中读取消息。

输入：

• chatId （字符串，可选）：聊天/对话ID
• recipient （字符串，可选）：收件人电话号码或电子邮件
• limit （数字，可选）：最大消息数（默认值：50）
• offset （number，可选）：要跳过的消息数（默认值：0）

imsg_get_conversations

获取所有iMessage对话的列表。

输入：

• limit （number，可选）：最大对话数（默认值：50）
• offset （number，可选）：要跳过的对话数（默认值：0）

imsg_get_conversation_details

获取特定对话的详细信息。

输入：

• chatId （字符串，必填）：聊天/对话ID

安装

先决条件

• 包子 --所需运行时间
• macOS（iMessage功能所需）

再进行

bun install

配置

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

STDIO运输（本地）

{
  "mcpServers": {
    "imessage-kit": {
      "command": "bun",
      "args": ["run", "/path/to/imessage-kit-mcp/src/index.ts"]
    }
  }
}

HTTP传输

{
  "mcpServers": {
    "imessage-kit": {
      "command": "bun",
      "args": ["run", "/path/to/imessage-kit-mcp/src/index.ts", "--port", "3002"],
      "url": "http://localhost:3002/mcp"
    }
  }
}

使用VS代码

将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [],
    "servers": {
      "imessage-kit": {
        "command": "bun",
        "args": ["run", "/absolute/path/to/imessage-kit-mcp/src/index.ts"]
      }
    }
  }
}

发展

运行服务器

# STDIO transport (default)
bun run src/index.ts

# HTTP transport
bun run src/index.ts --port 3002

MCP检验员测试

bunx @modelcontextprotocol/inspector src/index.ts

项目结构

imessage-kit-mcp/
├── src/
│   ├── index.ts           # Main entry point
│   ├── server.ts          # MCP server implementation
│   ├── client.ts          # iMessage Kit SDK client wrapper
│   ├── config.ts          # Configuration management
│   ├── cli.ts             # CLI argument parsing
│   ├── types.ts           # TypeScript type definitions
│   ├── tools/
│   │   ├── index.ts       # Tool exports
│   │   └── imessage.ts    # iMessage tool definitions
│   └── transport/
│       ├── index.ts       # Transport exports
│       ├── stdio.ts       # STDIO transport
│       └── http.ts         # HTTP transport
├── package.json
├── tsconfig.json
└── README.md

备注

• 此服务器需要macOS才能访问iMessage功能
• 需要Bun（使用 bun:sqlite 用于本地SQLite访问）
• 使用iMessage Kit访问数据库
• 确保您拥有在macOS上访问“消息”的适当权限