전송 모드

server는 클라이언트와 통신하는 두 가지 방식을 지원합니다. stdio와 HTTP입니다. stdio가 기본값이며 거의 모든 경우에 이 방식을 쓰면 됩니다. HTTP는 클라이언트와 server가 같은 프로세스가 아닌 환경을 위한 것입니다.

어떤 방식을 쓸까

빠른 시작을 따라 했다면 이미 stdio를 쓰고 있으며, 추가 설정은 필요 없습니다.

stdio 모드(기본값)

클라이언트가 server를 자식 프로세스로 실행하고 표준 입출력으로 메시지를 주고받습니다. 빠른 시작의 모든 설정 예시가 이 모드를 사용합니다. 형태는 항상 동일합니다:

{
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

클라이언트가 프로세스를 소유하므로 API 키는 env를 통해 전달됩니다. 포트도 URL도 없습니다.

HTTP 모드

server를 직접 실행하고 클라이언트가 네트워크로 접속하게 합니다. HTTP 모드는 하나의 프로세스에서 두 개의 엔드포인트를 제공합니다:

• /mcp의 Streamable HTTP — HTTP를 지원하는 대부분의 MCP 클라이언트가 기대하는 엔드포인트입니다.
• /sse의 Server-Sent Events(SSE) — SSE 전송을 사용하는 클라이언트용입니다.

server를 실행합니다:

export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000

set LISTENHUB_API_KEY=your_api_key_here
npx @marswave/listenhub-mcp-server --transport http --port 3000

--port 3000을 사용하면 엔드포인트는 다음과 같습니다:

• Streamable HTTP: http://localhost:3000/mcp
• SSE: http://localhost:3000/sse

클라이언트가 streamable HTTP 엔드포인트를 가리키도록 설정합니다:

{
  "mcpServers": {
    "listenhub": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

다음 단계