トランスポートモード
ListenHub MCP server を stdio（デフォルト）または HTTP で実行し、クライアントに合ったモードを選びます。
server は、クライアントとの通信方式として stdio と HTTP の 2 つに対応しています。stdio がデフォルトで、ほとんどの場合はこちらを使うべきです。HTTP は、クライアントと server が同じプロセスではない構成向けです。
どちらを使うか
| モード | 使う場面 | クライアントの接続方法 |
|---|---|---|
| stdio（デフォルト） | デスクトップアプリやエディタのクライアントが server を起動してくれる場合 — Claude Desktop、Cursor、Windsurf、Zed、Cline、Claude CLI、Codex CLI。 | クライアント設定の command + args。 |
| HTTP | server を独立して動かし（リモートホスト、コンテナ、共有の開発マシンなど）、クライアントが URL 経由で接続する場合。 | server の /mcp エンドポイントを指す url。 |
クイックスタートのとおりに設定していれば、すでに 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 モードでは、同一プロセスから 2 つのエンドポイントを公開します：
- ストリーミング対応 HTTP（Streamable HTTP）：
/mcp— HTTP に対応した MCP クライアントの多くが想定するエンドポイント。 - Server-Sent Events（SSE）：
/sse— SSE トランスポートを使うクライアント向け。
server を起動します：
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 キーはクライアント設定ではなく server プロセス側（起動前にエクスポートした LISTENHUB_API_KEY）に置かれます。この URL に到達できる人は誰でもあなたのアカウントのクレジットを消費できるため、server は信頼できるネットワーク内に置き、独自のアクセス制御なしに公開しないでください。