@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	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

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