suprsonic-mcp

官方

一个API密钥，为您的AI代理提供数十种能力。零提供商认证。

GitHub

你可以用 Suprsonic MCP 做什么？

  • 搜索网络 — 让助手使用 search 搜索当前信息，可选择 AI 合成结果或原始 SERP 数据。
  • 提取网页内容 — 通过 scrape 从任意 URL 请求干净的 Markdown 提取内容。
  • 查找专业联系人 — 使用 profiles 查找个人资料，并通过 emails 发现电子邮件地址。
  • 生成图像和语音 — 使用 images 根据文本提示创建图像，并通过 tts 将文本转换为语音音频。
  • 转录和字幕媒体 — 使用 stt 或 transcribe（含说话人标签）转录音频文件，并通过 subtitle 生成 SRT/VTT 字幕。
  • 处理文档和文件 — 使用 documents 从 URL 提取结构化数据，通过 invoice-parse 解析发票，利用 file-convert 在 200 多种格式间转换，并使用 screenshot 捕获网页截图。

文档

@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将任意 URL 的内容提取为 Markdown
profiles通过姓名或 LinkedIn URL 查找专业档案
emails查找专业电子邮件地址
images根据文本提示生成图像
tts将文本转换为语音
stt将音频转录为文本
sms发送短信或 WhatsApp 消息
documents从 URL 中提取结构化数据
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