suprsonic-mcp Server

官方

一個 API 金鑰，為你的 AI 代理提供數十種功能。無需供應商驗證。

GitHub

文件

@suprsonic/mcp

Suprsonic 的 MCP 伺服器。透過單一連線，為任何 AI 代理提供數十種功能。

快速入門

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

在 suprsonic.ai/app/apis 取得您的 API 金鑰。

Claude Desktop

新增至 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "@suprsonic/mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Cursor / VS Code

新增至 .cursor/mcp.json 或 VS Code MCP 設定：

{
  "suprsonic": {
    "command": "npx",
    "args": ["-y", "@suprsonic/mcp"],
    "env": {
      "SUPRSONIC_API_KEY": "omk_your_key"
    }
  }
}

遠端 HTTP（適用於 Claude API、ChatGPT、程式化代理）

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp --http --port 3100

然後連線至 http://localhost:3100/mcp。

可用工具

工具功能說明
search搜尋網頁（AI 合成、SERP 或兩者兼具）
scrape從任何網址擷取內容並轉為 Markdown
profiles依姓名或 LinkedIn 網址尋找專業人士檔案
emails尋找專業人士的電子郵件地址
images從文字提示生成圖片
tts將文字轉換為語音
stt將音訊轉錄為文字
sms發送簡訊或 WhatsApp 訊息
documents從網址擷取結構化資料
companies依網域查詢公司資料
email-verify檢查電子郵件是否可送達
transcribe轉錄音訊並標註說話者
invoice-parse從發票中擷取資料
subtitle生成 SRT/VTT 字幕
file-convert在 200 多種格式間轉換檔案
bg-remove移除圖片背景
screenshot擷取網頁截圖

回應格式

每個工具都會回傳一個統一格式的回應物件：

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

當失敗時，success 為 false，且 error 包含詳細資訊（見下方說明）。

錯誤處理

錯誤物件結構（當 success 為 false 時回傳）：

{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

錯誤類別：transient（可安全重試）、permanent（錯誤請求）、authentication（無效金鑰）、billing（點數不足）。

使用 MCP 時，AI 代理會在工具回應中收到錯誤，並可根據 is_retriable 和 retry_after_seconds 決定是否重試。

完整 API 參考文件，包含所有參數與範例回應：suprsonic.ai/apis