remote-mcp

oddsockets

面向编码 Agent 的实时消息传递——Agent 可通过命令行自行配置发布/订阅、在线状态和历史记录。

只需一条命令即可构建原型。将相同的频道部署到生产环境——无需重写。

你的 Agent 可以编写应用，却无法在不让你停下来配置消息服务的情况下，为应用提供实时消息基础设施。oddsockets 是 Agent 可自行运行的 CLI：安装一次，它就会注册、生成自己的密钥，并开始向实时频道发布消息和订阅消息——这些频道与你的生产流量使用的是同一批频道。零依赖。

适用对象： Claude Code · Cursor · Cline · Windsurf · Aider · Codex · 任意终端

60 秒内从注册到发送第一条实时消息——观看完整演示。

实时演示

下面的每个演示都是一次真实 CLI 会话——临时账号、真实密钥，以及通过实时集群发送的真实消息——并与展示相同流量的开发者仪表板拼接在一起。点击任意标签即可观看完整分辨率的视频。

注册 → 发送第一条消息	实时发布/订阅	谁在线	Agent 集成
新建应用，几秒内发送第一条消息	一个频道，两条消息，即时送达	实时成员列表	一行代码调用 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

发布/订阅——一个频道，实时通信

核心原语：向频道发布消息，订阅频道以实时接收消息。每个订阅者都会在消息送达时立即收到，无需轮询，也无需运行队列。

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

历史记录——重放错过的内容

频道会保留滚动消息历史，因此较晚连接的客户端（或上下文重置后的 Agent）可以追赶进度。

oddsockets history agent-bus --limit 10

Agent 集成

将以下内容添加到你的 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 客户端连接到我们托管的服务，你的 Agent 就能使用 12 个原生工具：发布消息、查看历史记录、查询在线状态、管理频道和管理 API 密钥。

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>	撤销密钥

管理（超级管理员）

通过命令行运行整个平台的运维命令，包括集群监控、租户/密钥配置、会话和安全管理。凭据分属三个平面；运行一次 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]	管理器磁盘信息卡（摘要/使用情况/IO）
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>	检查单个会话
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
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 — 为单条命令覆盖 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 安全结账），试用期间不会扣款——在试用结束前取消即可，完全免费。Agent 和 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 上构建和运营实时功能——包括频道、在线状态、发布/订阅、投递保证和生产环境实时运营——并直接在该技术栈上完成。认证分为三个等级（TCU / TCA / TCP），由 tyga.games 认证，并通过 ClassaaS 交付。

在 tyga.games 获取认证 →

链接

• 文档
• 控制面板
• GitHub