Wavix

官方

Wavix是一个全球通信平台，提供语音、短信、双因素认证和电话号码的API。我们的MCP服务器将这些功能引入AI代理和代理工作流中。

GitHub

试用此 MCP赞助

你可以用 Wavix MCP 做什么？

发送交易短信/彩信 — 通过 sms_and_mms_messages_send 请求发送消息，返回消息 ID 和投递状态。
运行 2FA 验证流程 — 使用 two_fa_verification_create 创建验证码，然后通过 two_fa_verification_check 进行验证。
搜索并购买电话号码 — 使用 buy_numbers_list 查找可用号码，通过 cart_add 加入购物车，并使用 cart_checkout 完成购买。
搜索通话记录 — 使用 cdrs_search 按转录关键词查找通话，然后通过 cdrs_get 丰富结果。
拉取并转录录音 — 通过 call_recording_get 获取录音，使用 cdrs_retranscribe 请求转录，并通过 cdrs_transcription_get 获取结果。
审计账单和发票 — 使用 billing_transactions_list 查看支出，并通过 billing_invoices_download 下载发票 PDF。

文档

Wavix MCP Server

一个模型上下文协议服务器，让 LLM 和 AI 代理能够直接访问 Wavix 电信平台 — 短信/彩信、语音通话、2FA、SIP 中继、电话号码管理、10DLC 注册、通话录音、语音分析和计费。

Wavix 是一个全球通信平台，通过单一 API 发送短信、发起语音通话和运行 2FA 流程。提供免费试用；付费使用遵循您账户所关联的 Wavix 定价方案。

使用此 MCP 服务器最快的方式是 托管端点，地址为 https://mcp.wavix.com/mcp — 将任何兼容 MCP 的客户端指向该端点，并使用您的 Wavix API 密钥进行身份验证。如果需要自托管（自定义 Wavix 部署、防火墙后面、专用实例），请参阅自行运行。

端点
安装 — 一键安装、Claude Code、Claude Desktop / Web、Cursor、VS Code、Codex CLI、Windsurf
自行运行（自托管）
示例
工具 → TOOLS.md 中的完整目录
资源
身份验证（最佳实践、如果令牌被泄露）
故障排查
兼容性与限制
支持、贡献、安全、许可证

端点

字段	值
URL	`https://mcp.wavix.com/mcp`
传输	Streamable HTTP
身份验证	`Authorization: Bearer <api_key>`
工具	参见 TOOLS.md
资源	Wavix 文档 + OpenAPI 规范（自动发现）

从 Wavix Console → Administration → API keys → Create new 获取 Wavix API 密钥。

安装

开始之前： 获取您的 Wavix API 密钥。

登录 https://wavix.com。
打开 Administration → API keys。
点击 Create new（或复制现有密钥）。请妥善保管 — 您将在下面将其粘贴到 YOUR_API_KEY 的位置。

一键安装

⚠️ 下方的按钮会向您的编辑器 MCP 配置中注入一个占位令牌 YOUR_API_KEY。 编辑器完成安装后，请打开生成的配置，在发送任何请求之前将占位符替换为您的真实 API 密钥 — 否则每次调用都会返回 401 Unauthorized。

日后移除： 打开同一配置文件（~/.cursor/mcp.json、.vscode/mcp.json 或您编辑器对应的等效文件），删除 wavix 条目，或通过编辑器的 MCP / Connectors 界面移除连接器。

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

使用 claude mcp list 进行验证，并在会话中使用 /mcp 查看状态。

Claude Desktop / Claude Web

设置 → Connectors → Add custom connector：

名称：Wavix
URL：https://mcp.wavix.com/mcp
传输：Streamable HTTP
身份验证头：Authorization: Bearer <api_key>

Cursor（手动）

添加到 ~/.cursor/mcp.json（或项目级 .cursor/mcp.json）：

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ 提供完整目录；早期版本上限为 40 个。

VS Code（手动，GitHub Copilot Chat）

在工作区中创建 .vscode/mcp.json（或在用户 settings.json 的 "mcp" 键下添加相同的 servers 对象）：

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

有关最新架构，请参阅 VS Code MCP servers 指南。

Codex CLI

Codex CLI 支持通过 stdio 使用 MCP。通过 mcp-remote 桥接到托管服务器。编辑 ~/.codex/config.toml：

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / 其他客户端

任何支持带自定义头的 Streamable HTTP 传输的 MCP 客户端都可以使用。请使用：

URL：https://mcp.wavix.com/mcp
头：Authorization: Bearer <api_key>

通过 AI 代理进行设置？ 将您的代理指向 llms-install.md — 这是一份机器可读的安装指南，以确定性格式为模型提供 URL、头和各客户端配置，避免其随意编造端点值。

自行运行

对大多数用户而言，托管服务器开箱即用。如果您需要指向非公开的 Wavix 部署、在防火墙后面运行，或在自有基础设施内运行，请自行托管。

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

服务器监听 8000 端口，并在 /mcp 暴露 MCP 端点。将您的客户端指向 http://<host>:8000/mcp。

从源码构建

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

需要 Python 3.10 或更高版本。

配置

环境变量	默认值	用途
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	覆盖上游 Wavix API 端点（用于内部部署或预发布环境）

运行服务器无需 Wavix 凭据 — 它们会从 MCP 客户端的 Authorization: Bearer <api_key> 头中按请求转发。自托管者负责在服务器前终止 TLS（nginx、Caddy、云负载均衡器），然后再将其公开暴露。

示例

可直接放入任何已连接客户端的实用提示词。

下方的电话号码（+1 310 555 0100、+44 7700 900123）位于保留测试号段（NANP 555 和 Ofcom 070 09xx）— 可以放心原样复制，通过这些号码无法联系到真实用户。

发送事务性短信

提示词： "从 +13105550100 向 +447700900123 发送短信，内容为 '您的验证码是 4821'。"

代理调用 sms_and_mms_messages_send，传入 from、to 和 text。返回消息 ID 和投递状态。

运行 2FA 验证

提示词： "通过 SMS 向 +13105550100 发送 2FA 验证码。当我告诉您收到的验证码后，请检查其是否正确。"

代理调用 two_fa_verification_create，等待您分享通过 SMS 收到的验证码，然后调用 two_fa_verification_check。适用于在不编写集成代码的情况下原型化无密码流程。

查找并购买电话号码

提示词： "查找一个支持 SMS 的美国免费电话号码，将其加入购物车并结账。"

代理依次调用 buy_numbers_list（按国家和功能筛选）、cart_add 和 cart_checkout。结账前请与用户确认 — 这将从账户扣费。

搜索通话转写

提示词： "显示昨天所有时长超过两分钟、且来电者提到 'refund' 的呼入电话。"

代理对转写文本使用 cdrs_search，然后通过 cdrs_get 丰富每条结果的完整通话元数据。

获取录音并转写

提示词： "获取通话 abc-123 的录音，请 Wavix 转写它，并返回转写结果。"

代理调用 call_recording_get（返回预签名下载 URL）、cdrs_retranscribe，然后轮询 cdrs_transcription_get。

审计计费

提示词： "上个月我们在 SMS 上花了多少钱？给我最近一张发票 PDF 的下载链接。"

代理按类型和日期筛选调用 billing_transactions_list，然后调用 billing_invoices_list + billing_invoices_download。下载工具返回 PDF 的预签名 URL，而非文件本身 — 请在浏览器中打开该 URL，或将其传递给客户端以获取实际文档。

工具

122 个工具，根据 Wavix OpenAPI 规范生成。参数与请求参数和请求体字段一一对应。

分组	数量	覆盖范围
SMS 和 MMS	10	发送、列出、检索消息；发送者 ID；退订
呼叫控制	9	开始/接听/结束通话；播放音频；收集 DTMF
通话录音	4	列出、下载（预签名 URL）、删除
通话流媒体	2	开始/停止媒体流
通话 Webhooks	3	列出、创建、删除
CDRs	7	列出、导出、检索；转写搜索和重新转写
语音分析	4	上传、转写、检索原始文件
2FA	6	创建/检查/取消/重发验证；事件
我的号码	6	列出、更新、释放；SMS / 语音路由；文档上传
购买	5	国家、地区、城市；可用号码搜索
购物车	4	添加、移除、检索、结账
号码验证器	3	单个和批量验证
SIP 中继	5	完整 CRUD
10DLC	30	品牌、活动、审核、证据、事件订阅
资料	3	获取/更新资料；账户配置
API 密钥	4	列出、创建、激活/停用、删除
子账户	5	列出、创建、获取、更新；交易
计费	3	交易、发票、账单下载
语音活动	2	触发和检索
Wavix Embeddable (WebRTC)	5	小组件令牌 CRUD
短链接	2	创建短链接；指标

有关完整工具列表及一行描述，请参阅 TOOLS.md。权威来源是 Wavix OpenAPI 规范 — 您的客户端始终能看到当前实时目录。

资源

除工具外，服务器还将 Wavix 文档作为 MCP 资源暴露，使模型能够按需获取权威上下文，而不是依赖先验知识猜测。

URI 模式	内容
`wavix://docs/<path>`	来自 docs.wavix.com 的文档页面（通过 `llms.txt` 自动发现）。
`wavix://api/openapi.yaml`	完整的 Wavix OpenAPI 3.0 规范。

这两个来源 — docs.wavix.com 和 Wavix OpenAPI 规范 — 均公开可用，无需身份验证即可直接浏览。

资源在 resources/read 时惰性获取，并在服务器端缓存，TTL 为 1 小时。上游 Bearer 令牌从不转发到文档主机 — 仅转发到 api.wavix.com。

身份验证

来自客户端的每个请求都必须包含：

Authorization: Bearer <api_key>

服务器按请求将此头转发到 api.wavix.com。该令牌：

从不被记录日志，
在跨主机重定向时（例如预签名 S3 下载 URL）从不被转发，
从不被发送到文档主机。

如果您的客户端需要访问 call_recording_get、billing_invoices_download、speech_analytics_file_get 或 ten_dlc_brand_evidence_get 返回的预签名下载 URL，请直接获取，不要携带 Authorization 头。

最佳实践

为 MCP 使用专用 API 密钥。 在 https://wavix.com → Administration → API keys 创建单独的 API 密钥（或通过 api_keys_create 工具本身，从另一个会话创建）。这样您可以在不中断其他集成的情况下撤销 MCP 访问权限。
定期轮换。 将 API 密钥视为生产机密：按计划轮换，并在任何疑似泄露时轮换。
不要将 API 密钥提交到 git。 MCP 客户端配置很容易被意外提交，将令牌一并带入提交历史和 CI 日志。大多数客户端支持在头值中进行 ${env:VAR} 替换 — 将 API 密钥存储在环境变量或操作系统钥匙串中，再从配置中引用。作为安全网，将常见的客户端配置路径添加到项目的 .gitignore 中：
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

如果令牌被泄露

在 Wavix 控制台中，立即停用该密钥（或调用 api_keys_deactivate）。
通过 api_keys_create 或控制台创建替换密钥。
更新客户端配置并重新连接。
检查 billing_transactions_list 和 cdrs_list 是否有异常活动。

故障排查

症状	可能的原因 / 修复方法
任何工具返回 `401 Unauthorized`	缺少或无效的 `Authorization: Bearer …` 请求头。请在 Wavix 控制台中确认 API 密钥处于激活状态。
工具返回 `download_url`，而非文件本身	符合预期。录音、发票、语音分析和 10DLC 证据端点返回预签名 URL（参见身份验证）。直接获取该 URL，无需携带 `Authorization` 请求头。
客户端仅显示约 40 个工具，而非完整目录	旧版客户端会强制限制每个服务器的工具数量。请升级（Cursor 2.4+、最新版 VS Code、最新版 Claude）。
本 README 中列出的工具提示 `Tool not found`	本地客户端可能缓存了旧的工具列表。请重启客户端，或移除后重新添加该服务器。
出现 4xx 错误并带有 `errors` 数组	来自 Wavix API 的校验错误。请检查 `errors`，并对照相关的 `wavix://docs/*` 页面或 OpenAPI 规范。
无法连接到服务器	确认 DNS 以及到 `mcp.wavix.com:443` 的出站 HTTPS 连接正常。
代理意外调用破坏性工具	大多数客户端可以要求在调用工具前进行确认——请启用该设置，并轮换使用专用的 MCP API 密钥（参见最佳实践）。

兼容性与限制

兼容任何支持 Streamable HTTP 传输的 MCP 客户端（Claude Desktop / Web / Code、Cursor 2.4+、VS Code、Windsurf、自定义 MCP SDK）以及任何带有 MCP 客户端适配器的代理框架。
旧版客户端可能强制限制每个服务器的工具数量；请升级到最新版本以访问完整目录。
速率限制和使用费用遵循您的 Wavix 账户套餐。参见 Wavix 定价。

更新日志

托管服务器会随 Wavix OpenAPI 规范的演进持续更新；新工具会自动出现，现有工具参数也可能增加可选字段。本仓库的文档变更记录在 Releases 中。对于影响工具输入或身份验证的重大行为变更，我们会在该页面以及 Wavix 发布说明中发布通知。

支持

产品文档：https://docs.wavix.com
API 参考：https://docs.wavix.com/api-reference
问题 / 反馈：support@wavix.com

贡献

本仓库源代码公开，但不接受外部贡献。拉取请求会被自动关闭，Issues / Discussions 已禁用。请将错误报告、功能请求和反馈发送至 support@wavix.com。详见 CONTRIBUTING.md。

如果您在底层 FastMCP 框架中发现错误，请在上游提交报告。

安全

如需报告安全漏洞，请发送邮件至 support@wavix.com，邮件主题为 Security: <short summary>，而不要创建公开的 Issue。详见 SECURITY.md。