Suprsonic Mcp

suprsonic-mcp

适用于 Suprsonic 的 MCP 服务。通过一个连接，为任意 AI Agent 提供数十种能力。

快速开始

连接托管服务，无需安装：

• URL：https://suprsonic.ai/v1/mcp（Streamable HTTP）
• 请求头：Authorization: Bearer omk_your_key（或者使用 x-api-key: omk_your_key，适用于将 Authorization 用于自身登录的客户端或网关）

或者在自己的机器上运行服务：

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

前往 suprsonic.ai/app/api 获取 API 密钥。两种方式提供的工具和价格相同。列出工具无需密钥；没有有效密钥的调用会返回 API 自身的错误，其中会说明获取密钥的方式。

该软件包名为 suprsonic-mcp。本 README 的早期版本曾使用 @suprsonic/mcp，但这个 npm 作用域属于另一家公司，因此切勿安装。

托管服务

Claude Code

claude mcp add --transport http suprsonic https://suprsonic.ai/v1/mcp --header "Authorization: Bearer omk_your_key"

Cursor

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

{
  "mcpServers": {
    "suprsonic": {
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer omk_your_key"
      }
    }
  }
}

VS Code

添加到 .vscode/mcp.json（VS Code 会要求输入一次密钥，并将其作为机密保存）：

{
  "inputs": [
    { "type": "promptString", "id": "suprsonic-key", "description": "Suprsonic API key (omk_...)", "password": true }
  ],
  "servers": {
    "suprsonic": {
      "type": "http",
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:suprsonic-key}"
      }
    }
  }
}

Claude API（MCP 连接器）

发送 beta 请求头 anthropic-beta: mcp-client-2025-11-20，并添加到 Messages 请求中：

{
  "mcp_servers": [
    { "type": "url", "url": "https://suprsonic.ai/v1/mcp", "name": "suprsonic", "authorization_token": "omk_your_key" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "suprsonic" }
  ]
}

OpenAI Responses API

添加到请求的 tools 中：

{
  "type": "mcp",
  "server_label": "suprsonic",
  "server_url": "https://suprsonic.ai/v1/mcp",
  "authorization": "omk_your_key",
  "require_approval": "never"
}

Smithery

Suprsonic 已在 Smithery 上列出，名称为 suprsonic。将其添加到 Smithery 工具箱，并在 Smithery 提示时粘贴密钥；Smithery 会通过 x-api-key 将密钥传递给托管服务。

本地服务（npx）

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 的 mcp.json。

自己的 HTTP 端点

若要在自己的机器上提供 HTTP 传输，而不是使用托管服务：

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

然后连接到 http://localhost:3100/mcp。

可用工具

只有调用成功时才会扣除积分。显示价格范围时，所选模式会决定价格。

工具	功能	积分
search	使用 SERP、AI 综合分析或两者结合来搜索网页	1-3
scrape	将任意 URL 的内容提取为 Markdown 或 HTML	1-5
profiles	查找并丰富专业人士资料	3
emails	查找专业人士的电子邮箱地址	2
images	根据文本提示生成图像	3
tts	将文本转换为语音音频	2
stt	将音频转写为带时间戳的文本	2
sound-generate	根据文本提示生成音效和短音乐曲目（不生成语音：语音请使用 tts）	4
sms	发送 SMS 或 WhatsApp 消息。默认渠道为 SMS（可靠送达）。WhatsApp 需要收件人选择加入：他们必须在 24 小时内向你的 Business 号码发送过消息。	1
documents	从 URL 或内容中提取结构化数据	3
companies	根据域名丰富公司数据	3
email-verify	检查电子邮箱是否可投递、是否为全收件邮箱或一次性邮箱	1
transcribe	转写音频，并进行说话人分离和添加时间戳	3
invoice-parse	从发票和收据中提取结构化数据	3
subtitle	根据音频或视频生成 SRT/VTT 字幕	2
file-convert	在不同格式间转换文档、网页、电子表格和图像	2
bg-remove	移除任意图像的背景，返回透明 PNG。	2
screenshot	截取任意网页渲染后的屏幕截图	1
code-execute	在预配置环境的安全沙箱中执行代码	2
site-intel	获取全面的域名情报：WHOIS、DNS、SSL、技术栈、电子邮件安全和托管信息	1-2
research	多步骤深度研究：搜索、抓取、丰富实体信息，并综合生成带引用的报告	10-35
video-info	提取任意 URL 中的视频元数据、可用格式和缩略图	1
video-download	下载任意 URL 中的视频，并返回临时下载链接	2-3
domains	查找适合企业的域名及其扩展名	1-5

响应格式

每个工具都会返回统一的响应对象：

{
  "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 中包含详细信息（见下文）。

错误处理

所有错误都采用相同的对象格式。功能调用失败时，会在上述响应中以 error 的形式返回该对象，并将 success 设为 false，且不扣除积分。调用被拒绝时（密钥无效、积分不足或触发速率限制），服务器会返回 HTTP 401、402 或 429，并在 detail 下附上该对象：

{
  "detail": {
    "type": "https://api.o-mega.ai/errors/insufficient-credits",
    "title": "Insufficient Suprsonic API credits",
    "status": 402,
    "detail": "This call needs 2 credits and your Suprsonic account has 0 left of its 200 free credits a month, which refill on November 12. This is your Suprsonic credit balance, not a provider's.",
    "is_retriable": false,
    "error_category": "billing",
    "alternative_action": "Pro gives 2,000 credits a month, 10 times the free plan: choose it at https://suprsonic.ai/app/subscription, or wait until November 12."
  }
}

错误类别：transient（可安全重试）、permanent（请求无效）、authentication（密钥无效）、billing（积分不足）、content_access（无法提供该 URL 的内容：内容被屏蔽、受地区限制或为私有内容）。

使用 MCP 时，AI Agent 会在工具响应中收到完整的错误对象，因此可以根据 is_retriable 和 retry_after_seconds 判断是否重试，并告知你 alternative_action 中建议采取的操作。

包含所有参数和响应示例的完整 API 参考：suprsonic.ai/apis