传输模式
ListenHub MCP server 支持 stdio（默认）与 HTTP 两种运行方式，按客户端场景选择。
服务器支持客户端与它通信的两种方式：stdio 和 HTTP。stdio 是默认方式，也是绝大多数场景的推荐选择。HTTP 适用于客户端与服务器不在同一进程的情况。
如何选择
| 模式 | 适用场景 | 客户端如何连接 |
|---|---|---|
| stdio（默认） | 桌面或编辑器客户端替你启动服务器——Claude Desktop、Cursor、Windsurf、Zed、Cline、Claude CLI、Codex CLI。 | 在客户端配置中填 command + args。 |
| HTTP | 服务器独立运行（远程主机、容器、共享开发机），客户端通过 URL 连接。 | 用指向服务器 /mcp 端点的 url。 |
如果你按快速开始配置过，你已经在用 stdio——无需额外设置。
stdio 模式（默认）
客户端把服务器作为子进程启动，并通过标准输入/输出交换消息。快速开始中的所有配置示例都使用该模式，形式始终一致：
{
"mcpServers": {
"listenhub": {
"command": "npx",
"args": ["-y", "@marswave/listenhub-mcp-server@latest"],
"env": {
"LISTENHUB_API_KEY": "your_api_key_here"
}
}
}
}由于进程由客户端管理，API key 通过 env 传入。没有端口，也没有 URL。
HTTP 模式
自行运行服务器，让客户端通过网络连接。HTTP 模式从同一进程暴露两个端点：
- 可流式 HTTP（Streamable HTTP），路径
/mcp——大多数支持 HTTP 的 MCP 客户端期望使用的端点。 - Server-Sent Events（SSE），路径
/sse——供使用 SSE 传输的客户端使用。
启动服务器：
export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000set LISTENHUB_API_KEY=your_api_key_here
npx @marswave/listenhub-mcp-server --transport http --port 3000当 --port 3000 时，端点为：
- 可流式 HTTP：
http://localhost:3000/mcp - SSE：
http://localhost:3000/sse
让客户端指向可流式 HTTP 端点：
{
"mcpServers": {
"listenhub": {
"url": "http://localhost:3000/mcp"
}
}
}在 HTTP 模式下，API key 随服务器进程存在（即启动前你 export 的 LISTENHUB_API_KEY），不在客户端配置里。任何能访问该 URL 的人都能消耗你账户的积分，因此请把服务器放在可信网络中，没有自己的访问控制前不要公开暴露。