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 伺服器

一個 Model Context Protocol 伺服器，讓 LLM 和 AI 代理能夠直接存取 Wavix 電信平台 — 包含 SMS/MMS、語音通話、雙因素驗證 (2FA)、SIP 中繼、電話號碼管理、10DLC 註冊、通話錄音、語音分析和帳務功能。

Wavix 是一個全球通訊平台，可透過單一 API 發送簡訊、撥打語音電話及執行 2FA 流程。提供免費試用；付費使用則依您帳戶所綁定的 Wavix 定價方案計費。

使用此 MCP 伺服器最快的方式是透過位於 https://mcp.wavix.com/mcp 的託管端點 — 將任何相容 MCP 的客戶端指向該端點，並使用您的 Wavix API 金鑰進行驗證。若您需要自行託管（自訂 Wavix 部署、位於防火牆後方、專用執行個體），請參閱自行執行。

端點

欄位	值
URL	`https://mcp.wavix.com/mcp`
傳輸方式	Streamable 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 / 其他客戶端

任何支援 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> 標頭中，依每個請求轉發。自行託管者需負責在伺服器前端（nginx、Caddy、雲端負載平衡器）終止 TLS，再將其公開。

範例

您可以在任何已連線的客戶端中直接使用的具體提示。

下方的電話號碼（+1 310 555 0100、+44 7700 900123）位於保留的測試範圍內（NANP 555 和 Ofcom 070 09xx）— 可安全地逐字複製，無法透過這些號碼聯繫到真實用戶。

發送交易簡訊

提示：「從 +13105550100 發送一則簡訊到 +447700900123，內容為『您的驗證碼是 4821』。」

代理會使用 from、to 和 text 呼叫 sms_and_mms_messages_send。回傳訊息 ID 和傳遞狀態。

執行 2FA 驗證

提示：「透過簡訊發送 2FA 驗證碼到 +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	完整 CRUD
10DLC	30	品牌、活動、審查、證據、事件訂閱
個人資料	3	取得 / 更新個人資料；帳戶設定
API 金鑰	5	列出、建立、啟用 / 停用、刪除
子帳戶	5	列出、建立、取得、更新；交易
帳務	3	交易、發票、對帳單下載
語音活動	2	觸發和擷取
Wavix Embeddable (WebRTC)	5	Widget 權杖 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 → 管理 → 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 金鑰（請參閱最佳做法）。

相容性與限制

相容於任何支援 Streamable HTTP 傳輸的 MCP 用戶端（Claude Desktop / Web / Code、Cursor 2.4+、VS Code、Windsurf、自訂 MCP SDK）以及任何具備 MCP 用戶端轉接器的代理框架。
較舊的用戶端可能強制執行每個伺服器的工具數量上限；請升級至最新版本以存取完整目錄。
速率限制與使用費用遵循您的 Wavix 帳戶方案。請參閱 Wavix 定價。

變更日誌

託管伺服器會隨著 Wavix OpenAPI 規範的演進持續更新；新工具會自動出現，現有工具參數可能會增加選用欄位。此儲存庫的文件變更會記錄在版本發布中。對於影響工具輸入或驗證的重大行為變更，我們將在該處以及 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。