sendsoon

SendSoon AI MCP

English | 简体中文 | 日本語

SendSoon MCP 是一个 Model Context Protocol (MCP) 服务，可让 Codex、Claude 和 WorkBuddy 使用 SendSoon 的功能：发送电子邮件、查询公网 IP，以及将本地文档转换为 Markdown。

只需配置一次，之后即可用自然语言描述任务。通常无需在每条提示词中都提及 SendSoon。

可以做什么

工具	用途	示例
send_email	发送一封电子邮件	“给我发送一封测试邮件”
ip_lookup	查询公网 IP 信息	“查询 8.8.8.8 的位置”
markitdown_convert	将本地文档转换为 Markdown	“将此 PDF 转换为 Markdown”

日常示例

Send an email to [email protected] with the subject “Meeting reminder” and the body “The meeting starts at 3 PM today.”

Look up the location and ISP for 8.8.8.8.

Convert /path/to/report.pdf to Markdown and summarize the key points.

如果 Agent 没有自动选择工具，请这样说：

Use the sendsoon MCP to complete this task.

在 AI 客户端中安装

以下说明适用于 Codex、Claude Desktop 和 WorkBuddy。

Codex

配置文件： 用户级 ~/.codex/config.toml（macOS / Linux）或 %USERPROFILE%\.codex\config.toml（Windows）。

[mcp_servers.sendsoon]
command = "npx"
args = ["-y", "@sendsoon/mcp"]

[mcp_servers.sendsoon.env]
SENDSOON_API_KEY = ""

验证： 保存文件，重启 Codex，然后在聊天中运行 /mcp。你应该会看到 sendsoon 已连接。在桌面应用中，还可检查 Settings > MCP servers。

首次使用： 开始新对话并提出一个简单任务（例如“查询 8.8.8.8”）。如果 Codex 请求权限，请批准使用该工具。

Claude Desktop

配置文件：

操作系统	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

你也可以在 Claude Desktop 中打开 Settings > Developer > Edit Config。

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": ["-y", "@sendsoon/mcp"],
      "env": {
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

验证： 保存文件，完全退出 Claude Desktop（包括系统托盘），然后重新启动。开始新的聊天，并确认工具菜单或设置中显示了 sendsoon 工具。

首次使用： Claude 可能会在首次调用时请求批准工具访问权限；请允许其继续。

WorkBuddy

在 WorkBuddy 中，可通过直接粘贴连接器 JSON 到 MCP Server Management 来添加 SendSoon。

配置文件： %USERPROFILE%\.workbuddy-ai\mcp.json（Windows）或 ~/.workbuddy-ai/mcp.json（macOS / Linux）。

1. 打开 WorkBuddy 并进入 MCP Server Management。
2. 点击 Add MCP。
3. 将以下 JSON 粘贴到编辑器中。如果你有 Key，请填写 SENDSOON_API_KEY；匿名试用时请留空。
4. 点击 Save。

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": [
        "-y",
        "@sendsoon/mcp"
      ],
      "env": {
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

截图展示了 WorkBuddy 连接器编辑器：配置文件路径位于顶部，编辑器中粘贴了 sendsoon JSON。保存后，返回 MCP 列表并确认 sendsoon 已连接。

验证： 开始新对话并提出一个简单任务（例如“查询 8.8.8.8”）。如果 WorkBuddy 请求权限，请批准使用该工具。

准备配置

可选环境变量：

设置	必需	填写内容
SENDSOON_API_KEY	否	未注册试用时请留空。一个公网 IP 每天最多可发送三封免费测试邮件。要继续使用，请填写你生成的 Key

切勿将真实 Key 提交到 Git 或分享给任何人。

获取 API Key

1. 在 SendSoon 注册页面注册或登录。
2. 打开 Profile，并在 API Key 部分生成 Key。
3. 立即复制一次性 ssk_live_... Key，并在 MCP 配置中将其填入 SENDSOON_API_KEY。
4. 保存配置并重启 MCP 客户端。使用有效 Key 的请求不会占用匿名 IP 每日配额。

如果匿名配额用尽，send_email 会提示你注册并配置 Key。无效或已撤销的 Key 会被拒绝，且不会回退到匿名配额。

在 Google Colab 中试用

跳过本地设置，直接在浏览器中试用 ip_lookup、markitdown_convert 和 send_email。

此笔记本调用的 SendSoon HTTP API 与这些 MCP 工具使用的 API 相同。

---

可视化本地测试（MCP Inspector）

在安装到 AI 客户端之前，如果要在浏览器中查看全部三个工具并手动逐一试用，请使用 MCP Inspector。

需要 Node.js 20+。在终端中运行以下命令；Inspector 会自动打开网页界面：

npx @modelcontextprotocol/inspector npx -y @sendsoon/mcp

如何测试

1. 等待终端中出现 MCP Inspector Web is up and running。如果浏览器未打开，请粘贴终端中的 http://127.0.0.1:6274?... URL。
2. 确认页面标题显示 Connected。
3. 打开页面右上角区域中的 Tools 选项卡。
4. 从左侧列表中选择一个工具，填写参数，然后点击 Execute Tool。
5. 在右侧的 Results 面板中查看响应。若失败，请检查 error.code 和 error.message。

许可证

请参阅 LICENSE。