Skip to content

feat(sms): 新增国内短信 MCP Server - #433

Closed
shaynecc wants to merge 1 commit into
volcengine:mainfrom
shaynecc:feat/sms-mcp
Closed

shaynecc wants to merge 1 commit into
volcengine:mainfrom
shaynecc:feat/sms-mcp

Conversation

@shaynecc

Copy link
Copy Markdown
Contributor

新增 server/mcp_server_sms 独立包,让 MCP 客户端通过现有短信 OpenAPI 完成开通检查、资质准备与提交、签名和模板申请、发送及结果查询。SMS 后端保持现状;材料收集、私密核对和用户确认由宿主负责,Server 不提供网页。

实现

  • 提供 37 个工具,支持 stdio 和 MCP 2026-07-28 Stateless Streamable HTTP,包版本为 0.1.0,接入仓库现有构建与 PyPI 发布流程。
  • HTTP 每次请求验证访问令牌并接收独立的短信调用凭据;草稿、文件和执行结果按用户隔离并加密,支持 SQLite 与共享 PostgreSQL。
  • 写操作使用固定预览、再次校验和执行去重;未知结果不自动重发。已执行结果按独立保留期查询,预览过期不影响核对。
  • 业务规则适配自指定的官方短信 Skill master 版本 1.4.4,保留 Apache-2.0 许可证。支持普通通知/营销群发;不包含特殊通知群发、验证码群发、公共模板、国际及港澳台短信。

已验证

  • Python 3.12:pytest -q 为 39 passed、1 skipped;Ruff 和 git diff --check 通过。
  • wheel / sdist 构建及 Twine 检查通过;最终 wheel 已用标准 MCP 客户端完成真实账号只读调用。
  • TraeWork 本地连接已验证资源查询、资质草稿创建/取消、非法材料拒绝,以及用户确认后单次发送。发送接口返回成功和 Message ID,送达回执尚未确认。
  • 发送验收后仅调整执行结果保留期查询并补充回归测试;发送路径未改变。

草稿 PR 的待验收项

  • 新增 CI 覆盖 Python 3.11/3.12 和独立 PostgreSQL 测试库;本机没有 PostgreSQL,相关测试在本地跳过。
  • 真实材料上传/OCR、手机号验证、资质/签名/模板申请提交和普通群发仍需业务验收。
  • 云端托管平台的认证、共享存储和私密文件通道仍需实际接入验证。

仓库不包含本次验收的手机号、账号资源 ID、凭据或材料。此 PR 不代表云端已部署或全流程已验收。

@shaynecc shaynecc closed this Sep 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant