Wavix

官方

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

GitHub

你可以用 Wavix MCP 做什么？

发送短信或彩信 — 让助手使用 sms_and_mms_messages_send 发送文本或媒体消息。
运行双因素认证流程 — 让助手通过 two_fa_verification_create 创建验证，并使用 two_fa_verification_check 检查收到的验证码。
搜索并购买电话号码 — 使用 buy_numbers_list 按国家和功能查找可用号码，将其加入购物车并完成购买。
分析通话记录 — 使用 cdrs_search 搜索包含特定短语的通话记录，并通过 cdrs_get 获取完整元数据。
下载录音和转录文本 — 通过 call_recording_get 获取通话录音链接，使用 cdrs_retranscribe 请求转录，并获取结果。
审计账单并下载发票 — 使用 billing_transactions_list 查看交易记录，并通过 billing_invoices_download 获取预签名的 PDF 下载链接。

文档

Wavix MCP 服务器

一个模型上下文协议服务器，为 LLM 和 AI 代理提供对 Wavix 电信平台 的直接访问——包括短信/彩信、语音通话、双因素认证、SIP 中继、电话号码管理、10DLC 注册、通话录音、语音分析和计费。

Wavix 是一个全球通信平台，可通过单一 API 发送短信、进行语音通话和运行双因素认证流程。提供免费试用；付费使用遵循您账户关联的 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`
传输方式	可流式 HTTP
认证	`Authorization: Bearer <api_key>`
工具	参见 TOOLS.md
资源	Wavix 文档 + OpenAPI 规范（自动发现）

从 Wavix 控制台 → 管理 → API 密钥 → 创建新密钥 获取 Wavix API 密钥。

安装

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

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

一键安装

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

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

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

设置 → 连接器 → 添加自定义连接器：

名称：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 服务器指南了解最新架构。

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 / 其他客户端

任何支持带有自定义头的 可流式 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'。"

代理使用 from、to 和 text 调用 sms_and_mms_messages_send。返回消息 ID 和送达状态。

运行双因素认证验证

提示： "通过短信向 +13105550100 发送一个双因素认证验证码。当我告诉您收到的代码时，检查它是否正确。"

代理调用 two_fa_verification_create，等待您分享通过短信收到的代码，然后调用 two_fa_verification_check。适用于无需编写集成代码即可原型化无密码流程。

查找并购买电话号码

提示： "查找一个支持短信功能的美国免费电话号码，将其添加到我的购物车，然后结账。"

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

搜索通话记录

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

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

获取录音并进行转录

提示： "获取通话 abc-123 的录音，让 Wavix 对其进行转录，并返回转录文本。"

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

审计计费

提示： "上个月我们在短信上花了多少钱？给我最新发票 PDF 的下载链接。"

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

工具

122 个工具，从 Wavix OpenAPI 规范生成。参数镜像请求参数和正文字段。

分组	数量	覆盖范围
短信和彩信	10	发送、列出、检索消息；发送者 ID；退订
通话控制	9	开始 / 应答 / 结束通话；播放音频；收集 DTMF
通话录音	3	列出、下载（预签名 URL）、删除
通话流	2	开始 / 停止媒体流
通话 Webhook	3	列出、创建、删除
通话详单	6	列出、导出、检索；转录搜索和重新转录
语音分析	4	上传、转录、检索原始文件
双因素认证	6	创建 / 检查 / 取消 / 重发验证；事件
我的号码	7	列出、更新、释放；短信 / 语音路由；文档上传
购买	5	国家、地区、城市；可用号码搜索
购物车	4	添加、移除、检索、结账
号码验证器	3	单个和批量验证
SIP 中继	5	完整的增删改查
10DLC	30	品牌、活动、审查、证据、事件订阅
个人资料	3	获取 / 更新个人资料；账户配置
API 密钥	5	列出、创建、激活 / 停用、删除
子账户	5	列出、创建、获取、更新；交易
计费	3	交易、发票、账单下载
语音活动	2	触发和检索
Wavix 嵌入式 (WebRTC)	5	小部件令牌增删改查
链接缩短器	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 → 管理 → API 密钥（或通过 api_keys_create 工具本身，从另一个会话）创建一个单独的 API 密钥。这使您可以在不中断其他集成的情况下撤销 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 密钥（参见最佳实践）。

兼容性与限制

兼容任何支持 可流式 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>，而不是打开公开问题。详情请参阅 SECURITY.md。