suprsonic-mcp Server

ทางการ

คีย์ API เดียว ความสามารถมากมายสำหรับ AI agent ของคุณ ไม่ต้องมีการยืนยันตัวตนจากผู้ให้บริการ

GitHub

เอกสาร

@suprsonic/mcp

เซิร์ฟเวอร์ MCP สำหรับ Suprsonic มอบความสามารถมากมายให้กับเอเจนต์ AI ผ่านการเชื่อมต่อเดียว

เริ่มต้นอย่างรวดเร็ว

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

รับ API key ของคุณได้ที่ suprsonic.ai/app/apis

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 หรือการตั้งค่า MCP ของ VS Code:

{
  "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ค้นหาโปรไฟล์มืออาชีพด้วยชื่อหรือ URL LinkedIn
emailsค้นหาที่อยู่อีเมลมืออาชีพ
imagesสร้างรูปภาพจากคำสั่งข้อความ
ttsแปลงข้อความเป็นเสียงพูด
sttถอดเสียงเป็นข้อความ
smsส่งข้อความ 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