内容
# 双击 CLI
<a href="https://glama.ai/mcp/servers/cseguinlz/double-tick-mcp-server">
<img width="380" height="200" src="https://glama.ai/mcp/servers/cseguinlz/double-tick-mcp-server/badge" />
</a>
用于通过 Gmail 跟踪电子邮件读取情况的开源 CLI 和 MCP 服务器。从终端了解您的电子邮件何时被打开。
与 [DoubleTick](https://doubletickr.com) 后端配合使用。从 CLI 发送的跟踪邮件会与 Chrome 扩展程序的跟踪邮件一同显示。
## 安装
```bash
npm install -g doubletick-cli
```
## 快速入门
```bash
# 1. 使用您的 Gmail 账户登录（一次性）
doubletick login
# 2. 发送跟踪邮件
doubletick send --to jane@company.com --subject "Q1 Planning" --body "Hi Jane, here are the numbers..."
# 3. 检查邮件是否被读取
doubletick status --last
```
## 命令
### `doubletick login`
使用 Gmail 和 DoubleTick 进行身份验证。打开浏览器进行 Google 登录。一次性设置 — 凭证存储在本地 `~/.doubletick/credentials.json` 中。
### `doubletick logout`
删除存储的凭证。
### `doubletick send`
发送跟踪邮件。注入读取跟踪像素，通过 Gmail API 发送，并注册跟踪。
```bash
# 发送跟踪邮件（默认情况下正文为 Markdown）
doubletick send --to jane@co.com --subject "Hi" --body "Hello **Jane**"
# HTML 正文而不是 Markdown
doubletick send --to jane@co.com --subject "Hi" --body "<h1>Hello</h1>" --html
# 正文来自文件
doubletick send --to jane@co.com --subject "Hi" --body-file ./email.md
# 带有抄送/密送
doubletick send --to jane@co.com --cc "bob@co.com" --subject "Hi" --body "Hello"
```
### `doubletick status`
检查跟踪邮件是否已被打开。
```bash
# 最近的跟踪邮件
doubletick status --last
# 按收件人查找
doubletick status --to jane@company.com
# 按跟踪 ID
doubletick status abc-123
```
### `doubletick dashboard`
列出所有跟踪邮件及其打开率和统计数据。
```bash
doubletick dashboard
doubletick dashboard --limit 50
```
## MCP 服务器
DoubleTick 作为 [MCP 服务器](https://modelcontextprotocol.io) 工作，以便 AI 代理（Claude Code、Claude Desktop 等）可以原生发送和跟踪邮件。
### 设置
将以下内容添加到您的 Claude 配置中：
```json
{
"mcpServers": {
"doubletick": {
"command": "npx",
"args": ["-y", "doubletick-cli"]
}
}
}
```
您必须先运行 `doubletick login` — MCP 服务器使用相同的存储凭证。
### 工具
| 工具 | 描述 |
|------|-------------|
| `send_tracked_email` | 发送带有读取跟踪的邮件 |
| `check_tracking_status` | 检查跟踪邮件是否已被打开 |
| `list_tracked_emails` | 列出最近的跟踪邮件及其统计数据 |
## 工作原理
1. 您撰写一封邮件（文本或 Markdown）
2. CLI 将其转换为 HTML，生成跟踪 ID，并注入 1x1 跟踪像素
3. 邮件通过 Gmail API 发送
4. 跟踪被注册到 DoubleTick 的后端
5. 当收件人打开邮件时，像素被触发，打开记录被记录
6. 您通过 `doubletick status` 检查状态
整个 DoubleTick 后端（像素服务、打开日志、重复数据删除、设备检测）保持不变。CLI 只是一种新的方式来注入像素 — 替换终端/代理工作流中 Chrome 扩展程序的角色。
## 架构
```
doubletick CLI / MCP 服务器
├── Gmail API → 发送邮件
└── DoubleTick API → 注册跟踪，检查状态
├── GET /img?t=<id> → 跟踪像素
├── POST /track → 注册跟踪邮件
├── GET /status?id= → 检查打开情况
└── GET /dashboard → 列出跟踪邮件
```
## 要求
- Node.js 18+
- Gmail 账户
- [DoubleTick](https://doubletickr.com) 账户（免费套餐：5 封跟踪邮件/周）
## 许可证
MIT
