remote-mcp

oddsockets

コーディングエージェント向けのリアルタイムメッセージング — パブリッシュ／サブスクライブ、プレゼンス、履歴を、エージェント自身がコマンドラインからプロビジョニングします。

1つのコマンドでプロトタイプを作成。本番環境でも同じチャネルをそのまま利用でき、書き直しは不要です。

エージェントはアプリを書けますが、メッセージングサービスの接続作業のために手を止めないと、リアルタイム通信の基盤を用意できません。oddsockets はエージェントが自ら実行する CLI です。インストールするだけで、エージェントが登録し、独自のキーを発行して、本番トラフィックを運ぶものと同じライブチャネルでパブリッシュとサブスクライブを開始します。依存関係はゼロです。

対応： Claude Code · Cursor · Cline · Windsurf · Aider · Codex · あらゆるターミナル

登録から最初のリアルタイムメッセージまで60秒 — デモ全編を見る。

動作を確認

以下の各デモは、使い捨てアカウント、実際のキー、ライブクラスター上の実際のメッセージを使った実際の CLI セッションを、同じトラフィックを表示する開発者ダッシュボードと組み合わせたものです。タブをクリックすると、高解像度の動画を見られます。

登録 → 最初のメッセージ	ライブのパブリッシュ／サブスクライブ	オンライン中のユーザー	エージェント連携
新しいアプリで、数秒で最初のメッセージ	1つのチャネルで2つのメッセージが瞬時に届く	ライブのメンバーリスト	1行で publish ＋ history

oddsockets.com でデモ全編を見る →

インストール

npm install -g oddsockets

クイックスタート

# 1. Sign up (instant API key, no email verification)
oddsockets signup my-app --local

# 2. Publish a message
oddsockets publish my-channel "Hello from the CLI!"

# 3. Subscribe (live tail)
oddsockets subscribe my-channel

# 4. Check who's online
oddsockets presence my-channel

パブリッシュ／サブスクライブ — 1つのチャネルでリアルタイムに

基本となる機能です。チャネルにパブリッシュし、サブスクライブしてリアルタイムで受信します。メッセージが届いた瞬間にすべてのサブスクライバーへ配信されるため、ポーリングもキューの実行も不要です。

oddsockets subscribe room-42 &                     # live tail in the background
oddsockets publish room-42 "hello from the CLI"    # arrives on the tail instantly
oddsockets publish room-42 --file payload.json     # publish structured data from a file

プレゼンス — 今、誰がオンラインか

接続中のクライアントを任意のチャネルで確認できます。プレゼンスはサーバー側で追跡され、クライアントの参加・退出に応じてリアルタイムで更新されます。

oddsockets subscribe lobby &     # join the channel
oddsockets presence lobby        # live member list

履歴 — 見逃した内容を再生

チャネルには直近のメッセージ履歴が保存されるため、後から接続したクライアントや、コンテキストをリセットした後のエージェントも、遅れを取り戻せます。

oddsockets history agent-bus --limit 10

エージェント連携

CLAUDE.md、.cursorrules、.clinerules、または .windsurfrules に追加します。

## OddSockets
Use the `oddsockets` CLI for real-time messaging.
Key is in .oddsockets/config.json (auto-loaded).

oddsockets status                           # cluster health
oddsockets publish my-channel "message"     # send message
oddsockets subscribe my-channel             # live tail
oddsockets presence my-channel              # who's online
oddsockets keys                             # list API keys

MCP サーバー（リモート）

CLI よりツールを使いたいですか？インストールは不要です。Claude Web、Claude Desktop、Cursor、Cline、Windsurf、Raycast、または任意の MCP クライアントからホスト済みサーバーに接続すると、エージェントがパブリッシュ、履歴、プレゼンス、チャネル、API キー管理のネイティブツール12個を利用できます。

URL:  https://mcp.oddsockets.ai/sse
Auth: Authorization: Bearer YOUR_API_KEY

まだキーをお持ちでない場合は、キーなしで接続して oddsockets_get_started を呼び出し、続けて oddsockets_signup を呼び出すと、アプリをセルフプロビジョニングして独自のキーを発行できます。その後、Bearer ヘッダーを付けて再接続すると、すべてのツールが使えるようになります。CLI と同じアカウント、同じチャネルを利用できます。

コマンド

セットアップ

コマンド	説明
oddsockets signup <app> [--email x] [--local]	登録して、すぐに API キーを取得します
oddsockets login --key KEY [--local]	既存の API キーを保存します
oddsockets logout [--local]	設定を消去します
oddsockets me	アカウント情報とプランを表示します
oddsockets status	クラスターの健全性とプラットフォーム統計を表示します

メッセージング

コマンド	説明
oddsockets publish <channel> "message"	メッセージを公開します
oddsockets publish <channel> --file data.json	ファイルから公開します
oddsockets subscribe <channel>	リアルタイムで追跡します（停止するには Ctrl+C）
oddsockets history <channel> [--limit 10]	メッセージ履歴を表示します
oddsockets presence <channel>	チャンネルのメンバーを表示します

チャンネル

コマンド	説明
oddsockets channels	チャンネル一覧を表示します
oddsockets channel create <name>	チャンネルを作成します
oddsockets channel delete <name>	チャンネルを削除します

API キー

コマンド	説明
oddsockets keys	API キー一覧を表示します
oddsockets key create "name"	新しいキーを作成します
oddsockets key revoke <id>	キーを無効化します

管理者（スーパー管理者）

CLI からプラットフォーム全体を運用するためのオペレーターコマンドです。フリート監視、テナント／キーのプロビジョニング、セッションとセキュリティの管理に対応します。認証情報は 3 つのプレーンにまたがります。oddsockets admin login で一度保存してください（マネージャー分析キー、ワーカーダッシュボードのベーシック認証、テナントのスーパー管理者キー）。すべてのコマンドでスクリプト用の --json を利用でき、ライブモニターでは --watch を利用できます。

コマンド	説明
oddsockets admin login [--key K] [--tenant-key T] [--worker-url U --dashboard-pass P]	任意のプレーンの認証情報を保存します
oddsockets admin config	設定済みのプレーンを表示します（機密情報は伏せ字）
oddsockets admin fleet [--watch] [--interval N]	フリートの健全性とワーカーごとのトラフィック表を表示します
oddsockets admin telemetry [--watch]	フリートのテレメトリをリアルタイムで表示します（キー不要）
oddsockets admin worker <id> [--watch]	ワーカーごとの詳細なメトリクスを表示します（ダッシュボードプレーン）
oddsockets admin worker <id> <section>	ワーカーのダッシュボードパネルを表示します（すべてのパネルは all）
oddsockets admin worker drain <id> --confirm	LB からワーカーを登録解除／ドレインします
oddsockets admin worker redis-toggle <id> --confirm	ワーカーの Redis アダプターを切り替えます
oddsockets admin disk [--watch]	マネージャーのディスクカード（概要／使用量／I/O）を表示します
oddsockets admin cache [--watch]	マネージャーの API キーキャッシュのヒット率統計を表示します
oddsockets admin analytics [mau|dau] [<apiKeyId>] [--watch]	MAU／DAU 上位テナントとキーごとの集計を表示します
oddsockets admin analytics history <apiKeyId>	30 日間の MAU／DAU 推移（ダッシュボードのグラフ）を表示します
oddsockets admin session stats [--watch]	スティッキーセッションの統計とワーカーごとの件数を表示します
oddsockets admin session get <id>	セッションを 1 件調査します
oddsockets admin session reassign <id> --confirm	セッションを現在のワーカーから移動します
oddsockets admin session cleanup --confirm	古いセッションを消去します
oddsockets admin apikey mint <name> [--plan P]	接続可能なテナントキーをプロビジョニングします
oddsockets admin users [--worker URL] [--status S]	接続中のユーザーをリアルタイムで表示します（ワーカープレーン）
oddsockets admin security status	ブロック済み IP とホワイトリスト登録済み IP を表示します
oddsockets admin security whitelist <ip>	IP をホワイトリストに登録します（ブロックも解除します）
oddsockets admin security block <ip> --confirm	マネージャーのエッジで IP をブロックします
oddsockets admin security clear --confirm	ブロック済みの IP をすべて解除します

ワーカーダッシュボードのセクション（admin worker <id> <section>）：stats、channels、connections、telemetry、messages、recent、threads、dms、notifications、reactions、files、presence、receipts、disk、redis、または all。

フラグ

• --json — すべてのコマンドで機械可読な JSON 出力を行います
• --key KEY — 1 回のコマンドに限り API キーを上書きします
• --local — プロジェクトローカルの設定（.oddsockets/）を使用します
• --watch — 管理モニター（fleet/worker/session/analytics）をライブ更新します
• --interval N — --watch の更新間隔を秒単位で指定します（デフォルトは 5）
• --confirm — 破壊的な管理操作（drain、block、cleanup、…）に必須です
• --help — ヘルプ

設定の優先順位

1. --key フラグ
2. ODDSOCKETS_API_KEY 環境変数
3. プロジェクトディレクトリ内の .oddsockets/config.json
4. ホームディレクトリ内の ~/.oddsockets/config.json

料金

すべてのプランで 7 日間の無料トライアルをご利用いただけます。 カードの登録が必要です（安全な Stripe 決済）。トライアル期間中に料金が請求されることはありません。終了前にキャンセルすれば、料金は一切かかりません。エージェントと CLI は、キーが必要になる前にプロトタイプを作成できる 48 時間のキー不要期間 を利用できます。プランは月額 29 ドルからです。詳細。

SDK

アプリに組み込んで使いたい場合は、OddSockets が主要な言語とランタイムすべてに対応するネイティブ SDK を提供しています。同じリアルタイムチャネル、パブリッシュ／サブスクライブ、プレゼンス機能を、それぞれのスタックに適した形式で利用できます。各カードからメンテナンスされているリポジトリにアクセスできます。使用言語で 60 秒でインストールして接続する手順については、examples/ をご覧ください。

Node.js	JavaScript	Svelte	React Native	Flutter
Python	Go	Rust	Java	Kotlin
C# / .NET	C++	C	PHP	Ruby
Swift	Elixir	Unity	Unreal Engine

SDK 一覧と主な特徴

言語 / ランタイム	リポジトリ	主な特徴
Node.js	oddsockets-nodejs-sdk	サーバーサイド、npm
JavaScript	oddsockets-javascript-sdk	ブラウザー + Node.js
TypeScript / Svelte	oddsockets-svelte-sdk	リアクティブストア
React Native	oddsockets-react-native-sdk	モバイル
Flutter / Dart	oddsockets-flutter-sdk	クロスプラットフォームのモバイル
Python	oddsockets-python-sdk	AsyncIO
Go	oddsockets-go-sdk	Goroutine セーフ
Rust	oddsockets-rust-sdk	Tokio 非同期処理
Java	oddsockets-java-sdk	Maven
Kotlin	oddsockets-kotlin-sdk	コルーチン
C# / .NET	oddsockets-csharp-sdk	NuGet
C++	oddsockets-cpp-sdk	C++17
C	oddsockets-c-sdk	組み込み / IoT
PHP	oddsockets-php-sdk	Composer
Ruby	oddsockets-ruby-sdk	Gem
Swift	oddsockets-swift-sdk	SPM + Combine
Elixir	oddsockets-elixir-sdk	GenServer / OTP
Unity	oddsockets-unity-sdk	MonoBehaviour
Unreal Engine	oddsockets-unrealengine-sdk	UE5

認定を取得する

OddSockets 上で、チャネル、プレゼンス、パブリッシュ／サブスクライブ、配信保証、本番環境でのライブ運用など、リアルタイム機能を構築・運用できることを実証できます。3 つのレベル（TCU / TCA / TCP）があり、tyga.games を通じて認定を受け、ClassaaS で提供されます。

tyga.games で認定を取得 →

リンク

• ドキュメント
• ダッシュボード
• GitHub