SendSoon AI MCP

English | 简体中文 | 日本語

在 Codex、Claude、Cursor 及其他 AI 代理中使用 SendSoon 的电子邮件、IP 查询和文件转 Markdown 功能。

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

你可以做什么

Related MCP server: Gmail & Google Docs MCP Server

在 Google Colab 中试用

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

该笔记本调用的是这些 MCP 工具所使用的同一套 SendSoon HTTP API。若要从 Cursor、Claude 或 Codex 中使用它们，请继续按照下面的本地 MCP 配置进行操作。

第 1 步：检查环境要求

• Node.js 20 或更高版本

• Codex、Claude、Cursor 或其他支持本地 stdio MCP 服务器的客户端

无需手动安装任何内容。下面的每种配置都会通过 npx 启动服务器，npx 会在首次使用时下载 @sendsoon/ai，之后会复用缓存副本。

如果你更倾向于从本地代码库运行，请参阅从源码构建。

第 2 步：准备配置

所有客户端使用相同的环境变量：

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

获取 API Key

1. 在 SendSoon 注册页面 注册或登录。

2. 打开个人资料，在 API Key 部分生成一个 Key。

3. 立即复制一次性 ssk_live_... Key，并将其作为 SENDSOON_API_KEY 填入你的 MCP 配置中。

4. 保存配置并重启你的 MCP 客户端。使用有效 Key 的请求不会消耗匿名 IP 的每日配额。

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

第 3 步：选择你的客户端

Cursor

在 Cursor 中打开 Settings > Tools & MCP 并添加一个 MCP 服务器。你也可以将以下配置保存为项目中的 .cursor/mcp.json 或用户目录下的 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": ["-y", "@sendsoon/ai"],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<YOUR_EMAIL>",
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

只使用一个顶层 mcpServers 对象。保存文件，重新打开 Cursor，并确认 sendsoon 已启用。

Codex

打开用户配置文件 ~/.codex/config.toml 并添加：

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

[mcp_servers.sendsoon.env]
SENDSOON_EMAIL_RECIPIENT = "<YOUR_EMAIL>"
SENDSOON_API_KEY = ""

保存文件并重新打开 Codex。使用 /mcp 确认 sendsoon 已连接。在桌面应用中，你也可以在 Settings > MCP servers 中查看。

Claude Code

替换占位符后运行：

claude mcp add --transport stdio --scope user --env SENDSOON_EMAIL_RECIPIENT=<YOUR_EMAIL> sendsoon -- npx -y @sendsoon/ai

在 Claude Code 中运行 /mcp 并确认 sendsoon 已连接。要使用 API Key，请在 sendsoon 服务器名称前添加 --env SENDSOON_API_KEY=<SENDSOON_API_KEY>。

Claude Desktop

从 Settings > Developer 打开配置文件并添加：

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": ["-y", "@sendsoon/ai"],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<YOUR_EMAIL>",
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

保存文件，完全退出并重启 Claude Desktop，确认 sendsoon 出现在工具列表中。

其他 MCP 客户端

对于 Windsurf、Cline、Continue 或其他支持本地 stdio MCP 服务器的客户端，请输入：

确认配置生效

重启客户端，打开新对话，然后输入：

Look up the location and ISP for 8.8.8.8.

如果代理调用了 ip_lookup 并返回结果，则说明 MCP 连接正常。

要测试电子邮件，请输入：

Send a test email to <YOUR_EMAIL> with the subject “SendSoon MCP test” and the body “Configuration successful.”

地址必须与 SENDSOON_EMAIL_RECIPIENT 完全一致。你的客户端可能在工具首次运行时请求权限；批准后即可继续。

日常示例

Look up information about 1.1.1.1.

Convert <YOUR_FILE_PATH> to Markdown and summarize the key points.

Send an email to <YOUR_EMAIL> with the subject “Meeting reminder” and the body “The meeting starts at 3 PM today.”

如果代理没有自动选择工具，请说：

Use the sendsoon MCP to complete this task.

通常只需要在首次使用时给出这个明确指令。

Agent Skills

本仓库还附带 Agent Skills，用于教导代理何时使用每个工具以及如何处理其错误代码。在 Claude Code 中，可以将其作为插件安装：

/plugin marketplace add sendsoon/ai
/plugin install sendsoon-skills@sendsoon

你也可以将 skills/ 下的任意文件夹复制到项目中的 .claude/skills/ 或用户目录下的 ~/.claude/skills/。

从源码构建

仅当你需要修改服务器或运行未发布版本时才需要。需要 pnpm 11。

git clone https://github.com/sendsoon/ai.git
cd ai
pnpm install
pnpm run build
pnpm run bundle

然后将你的客户端指向构建后的入口文件（而不是 npx），使用以下命令打印的绝对路径：

(Resolve-Path .\mcp\bin\sendsoon-mcp.mjs).Path.Replace('\', '/')

realpath ./mcp/bin/sendsoon-mcp.mjs

使用 "command": "node"，并将该绝对路径作为唯一参数。运行 pnpm run check 来检查代码风格并测试你的更改。

官方参考

• OpenAI Codex: Model Context Protocol

• Anthropic: Claude Code MCP

• Cursor: Model Context Protocol

• Model Context Protocol

许可证

参见 LICENSE。