DialMCP

DialMCP Connector

为你的 AI Agent 配备一部电话。
DialMCP 的开源连接器——这是一款托管式 MCP 服务，可让 AI Agent 使用你自己的已验证号码拨打真实电话。

这是什么

DialMCP 是部署在 https://mcp.dialmcp.com/mcp 的远程 MCP 服务。任何支持带 OAuth 的 Streamable HTTP 的客户端都可以直接连接——无需安装，也无需 API 密钥。这些客户端不需要此软件包。

此仓库的存在有两个原因：

1. 为仅支持本地服务的客户端提供 stdio 桥接。 一些 MCP 客户端仍无法与 远程服务通信。dialmcp-connector 会启动一个本地 stdio 服务，将请求代理到托管端点，并为你处理 OAuth 浏览器授权流程。
2. 以开放、规范的方式集中记录 DialMCP 集成文档——工具架构、客户端配置、 server.json 注册清单和安全模型都在一个可审计的位置。

托管电话服务本身为闭源。本连接器采用 MIT 许可证，不包含专有逻辑：它只是一个用于连接公共端点的轻量传输适配层。

快速开始

直接连接（首选）

如果你的客户端支持远程 MCP 服务，请跳过此软件包：

URL:        https://mcp.dialmcp.com/mcp
Transport:  Streamable HTTP
Auth:       OAuth 2.1 (sign in with your phone number)

claude mcp add --transport http dialmcp https://mcp.dialmcp.com/mcp
# add --scope user to enable it in every project

[mcp_servers.dialmcp]
url = "https://mcp.dialmcp.com/mcp"

首次连接时会打开浏览器窗口供你登录。使用 SMS 验证码验证你的电话号码——该号码将成为你的来电显示号码。

通过此连接器使用（仅支持 stdio 的客户端）

npx dialmcp-connector

或者在 MCP 客户端配置中使用：

{
  "mcpServers": {
    "dialmcp": {
      "command": "npx",
      "args": ["-y", "dialmcp-connector"]
    }
  }
}

可在 examples/ 中查看可直接粘贴使用的配置。

工具

该 API 从设计上采用异步模式：place_call 会立即返回通话 ID，随后由 Agent 轮询 get_call，因此持续数分钟的通话不会触发客户端的工具超时。

通话结束后，get_call 会返回结构化结果——achieved、partially_achieved 或 not_achieved——其中包含摘要、对方作出的承诺、建议的后续操作、逐轮对话转录文本，以及指向音频录音的签名链接。

通话期间，服务会通过自动化电话菜单按键操作，在等待音乐播放时静默等待，并检测语音信箱——检测到后会挂断，而不会留言。

安全模型

所有防护措施都在服务端执行，而不是作为 Agent 可能自行说服自己不遵守的模型指令。

• 披露身份。 每次通话开始时，都会先说明自己是 AI 助手、代表谁致电，以及通话会被录音，然后才提出请求。系统会独立核验每段通话记录是否合规，并记录结果。Agent 绝不会否认自己是 AI；如果接听者提出异议，通话便会结束。
• 你的真实号码。 通话会显示你本人通过 SMS 验证的来电显示号码。不会伪造号码，接听者也可以回拨给你。
• 速率限制。 同时最多 1 通 · 每小时 3 通 · 每天 10 通 · 同一目标每天最多 2 通 · 默认上限 6 分钟，硬性上限 10 分钟，由看门狗强制执行。系统从设计上杜绝了批量拨号。
• 时间与地点。 仅允许在接听者当地时间 8:00–21:00 拨打（符合 TCPA 要求），且仅限美国和加拿大。对于未知时区，将采取保守处理。
• 不可绕过的屏蔽列表。 绝不会拨打紧急服务号码（911）、高费率号码（900/976）和高欺诈风险号段。
• 永久退订。 通话中会确认对方的谢绝来电请求；第二次独立的通话记录审核也会核实该请求。退订记录将永久保存，并在整个平台的所有用户之间统一生效。用户可通过 https://mcp.dialmcp.com/opt-out 自助退订，无需账户。
• 客观审核。 独立审核员会在拨号前审核每通电话所述的目标，排查骚扰、欺骗或欺诈行为。Agent 只会陈述任务中提供的事实。
• 禁止用途。 禁止用于电话营销、陌生拜访、自动拨号、调查、潜在客户开发、债务催收和政治宣传，详见条款。

完整详情：https://dialmcp.com/safety.html

要求

• Node.js 18 或更高版本（仅在使用 stdio bridge 时需要）
• 用于 SMS 验证的美国或加拿大手机号码
• 用户必须年满 18 岁

链接

• 网站 — https://dialmcp.com
• 安全与反垃圾信息 — https://dialmcp.com/safety.html
• 隐私 — https://dialmcp.com/privacy
• 条款 — https://dialmcp.com/terms
• 谢绝来电退订 — https://mcp.dialmcp.com/opt-out
• 支持 — [email protected]

发布

每次发布都会同步到两个平台：npm（dialmcp-connector）和官方 MCP Registry（com.dialmcp/dialmcp）。两处发布均由 .github/workflows/release.yml 自动完成。

发布新版本

1. 更新 package.json 和 server.json 两处的 version。如果版本不一致，npm run validate:manifest 会失败；CI 会在每次推送时运行此命令。
2. 合并到 main。
3. 手动运行 Release 工作流（Actions → Release → Run workflow，保持勾选 dry_run），并等待工作流成功完成。此步骤会打包 tarball，并根据实时注册表架构验证 server.json，但不会发布任何内容。
4. 发布一个标记为 vX.Y.Z 的 GitHub Release。标签必须与 package.json 中的版本一致，否则工作流会在发布前停止。

第 3 步花两分钟就能完成，值得一做：注册表中的版本不可修改，也不能撤回发布。 有问题的版本只能由更高版本取代，或标记为弃用。

工作流的作用

--provenance 会附加一份签名证明，将 tarball 与构建它的提交和工作流运行关联起来，因此该 Job 需要 id-token: write。

注册表发布是一个独立 Job，原因有二。首先，它必须等待 npm：注册表会通过获取刚发布的版本并读取其 mcpName 字段来验证所有权；在 npm 完成同步之前，该请求会返回 404（此 Job 会重试约 2.5 分钟）。其次，它持有签名密钥；该密钥的作用范围是整个 com.dialmcp 命名空间，而非仅限此软件包，因此需要放在受保护的环境中。刻意不将该环境应用于 publish Job：其分支策略只允许 v* 标签，如果应用于整个 Job，就会直接阻止从 main 手动试运行。

一次性设置

TXT 记录应添加在裸域名上，类似 SPF 的设置方式——不会读取 _mcp. 选择器，且会导致难以诊断的签名错误。签名的时间戳窗口为 ±15 秒，因此运行器的时钟必须准确。

参与贡献

欢迎为连接器、文档和客户端配置提交问题和拉取请求。托管服务本身的 Bug 最好发送至 [email protected]。报告任何安全相关问题前，请先阅读 SECURITY.md。

许可证

MIT © Datawizz Inc. 详见 LICENSE。