内容
# ldm-inbox-check-mcp
> **用于 [Inbox Check](https://check.live-direct-marketing.online) 的 MCP 服务器** —
> 为 AI 代理提供跨 **9 个提供商**（Gmail、Outlook、Yahoo、iCloud、AOL、GMX、T-Online、Mail.ru、Yandex）的程序化电子邮件投递测试。
[📦 npm](https://www.npmjs.com/package/ldm-inbox-check-mcp) ·
[🌐 check.live-direct-marketing.online](https://check.live-direct-marketing.online) ·
[✨ awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) ·
[🔍 Glama](https://glama.ai/mcp/servers)
[](https://www.npmjs.com/package/ldm-inbox-check-mcp)
[](https://www.npmjs.com/package/ldm-inbox-check-mcp)
[](LICENSE)
[](https://modelcontextprotocol.io)
将实际的收件箱放置测试插入到 Claude Desktop、Cursor、Windsurf、Cline 或任何其他与 MCP 兼容的 AI 客户端中。该服务器封装了 Inbox Check REST API，并公开了 5 种工具，您的代理可以直接调用 — 创建测试，将您的电子邮件发送到返回的种子地址，并读取每个提供商的放置位置（收件箱 / 垃圾邮件 / 促销 / 更新）、身份验证结果（SPF、DKIM、DMARC）、头部和截图。
## 为什么使用它？
- **9 个真实的提供商邮箱** — Gmail、Outlook、Yahoo、iCloud、AOL、GMX、T-Online、Mail.ru、Yandex。不是模拟：实际的 IMAP 支持的种子账户，实际的过滤器判决。
- **身份验证验证** — SPF、DKIM、DMARC 对齐报告每次投递，从 `Authentication-Results` 头部解析。
- **文件夹检测** — 收件箱、垃圾邮件、促销、更新、社交、论坛、提供商公开的类别特定选项卡。
- **截图** — 为 Gmail、Outlook 等渲染收件箱 / 垃圾邮件列表视图，以便代理可以向用户显示收件人看到的内容。
- **无脆弱的爬取** — 服务运行自己的种子邮箱；您的代理只需与稳定的 REST API 对话。
- **为 AI 代理构建** — 通过 Zod 严格的 JSON 模式，确定性的工具名称，光标分页，幂等键。
## 它做什么
公开 5 种工具，封装 Inbox Check REST API：
| 工具 | 描述 |
| --- | --- |
| `inbox_check_create` | 创建放置测试；返回要发送电子邮件的种子地址。 |
| `inbox_check_status` | 获取每个提供商的放置位置、SPF/DKIM/DMARC、截图。 |
| `inbox_check_list` | 列出最近的测试，并使用光标分页。 |
| `inbox_check_delete` | 删除测试及其截图。 |
| `inbox_check_me` | 检查 API 密钥元数据、功能、配额使用情况。 |
## 安装
```bash
npx ldm-inbox-check-mcp
```
不需要全局安装 — Claude Desktop / Cursor / Windsurf / Cline 将按需运行它。
## 获取 API 密钥
1. 前往 <https://check.live-direct-marketing.online/docs>。
2. 联系操作员获取密钥（稍后将提供自助服务发布）。
3. 复制 `icp_live_...` 字符串 — 它只显示一次。
## 配置您的 MCP 客户端
### Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"inbox-check": {
"command": "npx",
"args": ["-y", "ldm-inbox-check-mcp"],
"env": {
"INBOX_CHECK_API_KEY": "icp_live_xxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
```
### Cursor
`~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"inbox-check": {
"command": "npx",
"args": ["-y", "ldm-inbox-check-mcp"],
"env": { "INBOX_CHECK_API_KEY": "icp_live_..." }
}
}
}
```
### Windsurf
`~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"inbox-check": {
"command": "npx",
"args": ["-y", "ldm-inbox-check-mcp"],
"env": { "INBOX_CHECK_API_KEY": "icp_live_..." }
}
}
}
```
### Cline (VS Code)
`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`（macOS）或您平台上的等效文件：
```json
{
"mcpServers": {
"inbox-check": {
"command": "npx",
"args": ["-y", "ldm-inbox-check-mcp"],
"env": { "INBOX_CHECK_API_KEY": "icp_live_..." }
}
}
}
```
## 环境变量
| 变量 | 必需 | 默认值 |
| --- | --- | --- |
| `INBOX_CHECK_API_KEY` | 是 | — |
| `INBOX_CHECK_BASE_URL` | 否 | `https://check.live-direct-marketing.online` |
仅在自托管部署或测试时覆盖基本 URL。
## 示例提示
> “使用 inbox-check 创建针对 Gmail、Outlook 和 Yahoo 的测试，然后等待 90 秒，并告诉我电子邮件的投递位置。”
> “列出我的最后 10 个 inbox-check 测试，并总结每个提供商的垃圾邮件率。”
> “创建一个测试，我会发送电子邮件，然后显示 SPF/DKIM/DMARC 结果，并告诉我哪个记录未对齐。”
## 用例
1. **冷邮件预热 QA** — 在活动之前，将草稿发送到种子地址，并让代理验证 Gmail + Outlook 的收件箱位置。
2. **身份验证调试** — 当域名开始进入垃圾邮件时，要求代理运行测试并指出失败的 SPF/DKIM/DMARC 检查。
3. **模板更改审查** — 比较单个代理运行中 9 个提供商的旧版和新版电子邮件模板的放置位置。
4. **共享 IP 声誉监控** — 安排定期测试，并在垃圾邮件率超过阈值时让代理提醒。
5. **事务邮件审核** — 验证密码重置 / 接收电子邮件等确实到达收件箱（而非促销）所有主要提供商。
## 相关
- [check.live-direct-marketing.online](https://check.live-direct-marketing.online) — 此 MCP 服务器背后的托管 Inbox Check 服务。
- [live-direct-marketing/ldm-sdk-js](https://github.com/live-direct-marketing/ldm-sdk-js) — 用于 LDM.delivery（AI 代理的电子邮件投递 API）的官方 TypeScript SDK + MCP 服务器。
- [live-direct-marketing/awesome-email-deliverability](https://github.com/live-direct-marketing/awesome-email-deliverability) — 整理的有关于电子邮件投递能力的工具、资源和最佳实践。
## 许可证
MIT © Live Direct Marketing
