Photon Imsg MCP

Photon iMessage MCP服务器

集成Photon iMessage SDK的MCP服务器实现，为AI代理提供读取、发送和自动化iMessage对话的能力。

特性

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

工具

photon_send_message

向收件人发送iMessage。

输入：

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

photon_read_messages

从iMessage对话中读取消息。

输入：

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

photon_get_conversations

获取所有iMessage对话的列表。

输入：

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

photon_get_conversation_details

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

输入：

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

安装

先决条件

• 包子 （建议零依赖）-从安装 bun.sh
• 或 Node.js 18+ 使用npm/yarn
• macOS（iMessage功能所需）

再进行

# Using Bun (recommended - zero dependencies)
bun install

# Or using npm/yarn (requires better-sqlite3)
npm install
# or
yarn install

配置

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

STDIO运输（本地）

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

HTTP传输

{
  "mcpServers": {
    "photon-imsg": {
      "command": "bun",
      "args": ["run", "/path/to/photon-imsg-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": {
      "photon-imsg": {
        "command": "bun",
        "args": ["run", "/absolute/path/to/photon-imsg-mcp/src/index.ts"]
      }
    }
  }
}

发展

运行服务器

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

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

# Or using npm scripts
npm run dev:stdio
npm run dev:http

建筑

# Build TypeScript
bun run build

# Or
npm run build

MCP检验员测试

npm run inspector

项目结构

photon-imsg-mcp/
├── src/
│   ├── index.ts           # Main entry point
│   ├── server.ts          # MCP server implementation
│   ├── client.ts          # Photon 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功能
• Photon SDK处理所有iMessage数据库访问
• 确保您拥有在macOS上访问“消息”的适当权限
• SDK使用Bun实现零依赖，但可以使用Node.js

许可证

MIT许可证-有关详细信息，请参阅许可证文件。