@suprsonic/mcp

Suprsonic 的 MCP 服务器。通过单一连接为任何 AI Agent 提供数十种功能。

快速开始

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 Agent 会在工具响应中收到错误，并可以根据 is_retriable 和 retry_after_seconds 决定是否重试。

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

suprsonic-mcp