能做什么
Stateful WebSocket session registry with per-connection Shannon entropy delta tracking for schema di
作者提供的原文
- 连接方式 在云端运行
- 账号或密钥 无需密钥
- 分类 开发者工具
可搭配使用
教 AI 做这类工作的 Skill,可与本项一起使用
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
为什么排在这里
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 0/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 7/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 0/8 | 上次检查时云端端点有响应 |
| 使用分 | 7/100 |
质量: 基础检查通过 2/4 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
安装
选择你使用的 AI 应用,然后复制设置。
通过 2/4 项检查 · 在你的电脑上运行
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
Claude 暂时无法连接 Npm Package Ws Has 241560546 Weekly Downloads But Sdk
还没有通过检查的安装方式。请看作者的说明,或选择同类的其他服务器
ChatGPT 暂时无法连接 Npm Package Ws Has 241560546 Weekly Downloads But Sdk
还没有通过检查的安装方式。请看作者的说明,或选择同类的其他服务器
你可以改用这些方式
B · 开发者工具 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code 暂时无法连接 Npm Package Ws Has 241560546 Weekly Downloads But Sdk
还没有通过检查的安装方式。请看作者的说明,或选择同类的其他服务器
Cursor 暂时无法连接 Npm Package Ws Has 241560546 Weekly Downloads But Sdk
还没有通过检查的安装方式。请看作者的说明,或选择同类的其他服务器
VS Code 暂时无法连接 Npm Package Ws Has 241560546 Weekly Downloads But Sdk
还没有通过检查的安装方式。请看作者的说明,或选择同类的其他服务器
还没有通过检查的安装方式。请看作者的说明,或选择同类的其他服务器
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
它能做什么
我们上次检查时服务器没有响应,所以无法读取它的工具。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月21日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 nexus-mcp-infra 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于3个月前
- ✕ 未通过
有许可证
仓库中没有找到许可证文件
- ✕ 未通过
端点有响应
我们检查时,6 秒内没有响应
- – 不适用
使用 OAuth 登录
我们检查时,6 秒内没有响应
- … 尚未检查
工具描述中没有隐藏指令
尚未检查;我们会在检查端点时读取工具列表
作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/nexus-mcp-infra-npm-package-ws-has-241560546-weekly-downloads-but-sdk)讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 6702 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 6702 个服务器的 20% 更新
- 基础检查结果等于或优于此分类中其他 6702 个服务器的 8%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Npm Package Ws Has 241560546 Weekly Downloads But Sdk 安全吗?
它在 4 项适用的基础检查中通过了 2 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于3个月前,最新版本(1.0.0)于4个月前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
有什么可以替代它?
同一分类中有:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
功能相近的其他选择
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 本项 Npm Package Ws Has 241560546 Weekly Downloads But Sdk | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 运行位置 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 云端或安装在电脑上都可以 |
| 需要密钥 | 否 | 否 | 否 | 否 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 是 | 否 | 否 |
| 基础检查 | 2/4 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 许可证 | – | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
ws-mcp
WebSocket session management as MCP tools — with per-frame Shannon entropy tracking.
ws has 241,560,546 weekly downloads. There are zero MCP servers that expose WebSocket primitives. This is that server.
The problem
AI agents cannot interact with live WebSocket streams without custom glue code per integration. There is no standardized way for an LLM to open a persistent connection, send a typed frame, and receive structured events as tool call responses. Debugging message flows requires external tooling (Wireshark, browser devtools) that is incompatible with agentic workflows.
ws-mcp exposes five atomic operations over HTTP: open a session, send a frame, drain buffered frames, inspect telemetry, and close. Each frame — inbound or outbound — is scored with a Shannon entropy delta relative to the session's cumulative message distribution, so an agent can detect when a stream is diverging from its expected schema without any external monitoring.
Why the entropy delta is not optional
The server maintains a live token-frequency Counter per session_id inside the same process that holds the socket open. For each frame, it computes:
delta = H(t) - H(t-1)
where H(t) is the Shannon entropy of the cumulative byte distribution after frame t. A delta near zero means the frame is statistically consistent with the session's established message pattern. A large positive delta means the frame introduced new information — schema divergence, anomalous payload, or a new message type.
This requires coupling MCP tool state with a live socket registry and a probabilistic frame classifier in the same process. It cannot be replicated by wrapping ws.send() in a stateless proxy.
Base URL
https://npm-package-ws-has-241560546-w-production.up.railway.app
Authentication
None. There is no API key, header, or auth mechanism of any kind on this asset today — every request is served regardless of headers sent.
Pricing
- `POST /ws-sessions/open` requires an x402 payment:
$0.01USDC on Base Sepolia (testnet), schemeexact. A request without payment gets402 Payment Requiredwith the payment details in thepayment-requiredresponse header. - All other operations (
send-frame,drain-frames,telemetry,close) act on a session that was already paid for at open time and are not separately charged.
Endpoints
POST /ws-sessions/open
Establishes a persistent WebSocket connection to a target URL and registers it in the stateful session registry. Returns a session_id for all subsequent operations. Requires an x402 payment (see Pricing above).
Use when an agent needs to initiate a long-lived connection before sending or receiving frames. Do NOT use to reconnect an already-open session — call close first, or use the session_id of an existing session.
Request
{
"target_url": "wss://echo.websocket.org", "connect_timeout_seconds": 10.0, "extra_headers": { "X-Custom-Header": "value" } }
target_url must start with ws:// or wss:// (validated, not just a regex in the schema). connect_timeout_seconds defaults to 10.0, range 0.5–60.0. extra_headers is optional (HTTP headers sent on the upgrade request).
Response (201)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "target_url": "wss://echo.websocket.org", "state": "OPEN", "opened_at_unix": 1785012145.03, "message": "Session '8662044208f54095b327ab4c29e1554c' is OPEN. Use session_id for all subsequent operations." }
session_id is a 32-character hex string (uuid.uuid4().hex, no dashes) — use it as-is in the paths below.
Errors: 422 if target_url doesn't start with ws:///wss://; 504 if the handshake doesn't complete within connect_timeout_seconds; 502 if the host is unreachable or refuses the connection; 503 if the server is already at NEXUS_WS_MAX_SESSIONS concurrent sessions.
POST /ws-sessions/{session_id}/send-frame
Sends a single text or binary frame over an open session and returns the frame's Shannon entropy delta relative to the session baseline.
Use for request-response patterns or publishing commands to a WebSocket server. Do NOT use to send a sequence of frames in bulk — call this endpoint once per frame. Fails if session_id does not exist or the connection is not in OPEN state.
Request
{
"payload": "{\"action\": \"subscribe\", \"channel\": \"trades\"}", "frame_type": "text" }
frame_type is "text" (default) or "binary" — if binary, payload must be a hex-encoded string.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "frame_type": "text", "payload_bytes": 44, "entropy_after": 4.237441, "entropy_delta": 0.245712, "schema_valid": true, "sent_at_unix": 1785012151.68 }
Errors: 404 if session_id is not in the registry (session_id ' ' not found in registry); 409 if the session isn't in OPEN state; 422 if frame_type is "binary" and payload isn't valid hex; 502 if the underlying socket send fails.
POST /ws-sessions/{session_id}/drain-frames
Returns up to max_frames buffered inbound frames received since the last drain (or session open), each annotated with its Shannon entropy delta and schema validation result.
Use to poll for incoming messages without holding a blocking connection. Do NOT use as a real-time streaming mechanism — it returns only frames already buffered (buffer capped at 512 frames per session; oldest frames are dropped once full).
Request
{
"max_frames": 10 }
max_frames defaults to 32, range 1–256.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "frames_returned": 2, "frames": [ { "payload": "{\"event\": \"trade\", \"price\": 42381.50}", "frame_type": "text", "entropy_after": 3.91, "entropy_delta": 0.12, "schema_valid": true, "received_at": 1785012155.203 }, { "payload": "{\"event\": \"liquidation\", \"size\": 180000, \"side\": \"long\"}", "frame_type": "text", "entropy_after": 5.38, "entropy_delta": 1.47, "schema_valid": false, "received_at": 1785012155.891 } ], "buffer_remaining": 0 }
The entropy_delta of 1.47 on the second frame combined with schema_valid: false indicates the stream introduced content statistically inconsistent with the session's established byte distribution — a signal an agent can use to decide whether to escalate or re-negotiate the subscription.
Errors: 404 if session_id is not in the registry.
POST /ws-sessions/{session_id}/telemetry
Returns real-time telemetry for a session: connection state, frame counts, cumulative and rolling Shannon entropy statistics, schema violation rate, and uptime. Takes no request body.
Use to diagnose whether a stream is diverging from its expected schema or to verify a session is still alive before sending. Do NOT use as the primary liveness check in a tight loop — it recomputes rolling statistics on every call.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "target_url": "wss://echo.websocket.org", "state": "OPEN", "uptime_seconds": 108.77, "frames_sent": 1, "frames_received": 2, "current_entropy": 4.16695, "rolling_entropy_mean": 0.18, "rolling_entropy_std": 0.31, "rolling_entropy_max": 1.47, "cumulative_entropy_bits": 4.16695, "schema_violations": 1, "schema_violation_rate": 0.333333, "inbound_buffer_depth": 2 }
Errors: 404 if session_id is not in the registry.
POST /ws-sessions/{session_id}/close
Sends a WebSocket close frame with the specified status code, waits for the server close handshake, and removes the session from the registry. Returns a final telemetry snapshot. session_id is permanently deallocated after this call and cannot be reused.
Request (both fields optional)
{
"status_code": 1000, "reason": "agent task complete" }
status_code defaults to 1000, range 1000–4999 (RFC 6455). reason defaults to "", max 123 bytes.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "target_url": "wss://echo.websocket.org", "final_state": "CLOSED", "frames_sent": 1, "frames_received": 2, "terminal_entropy": 4.16695, "schema_violations": 1, "uptime_seconds": 310.2, "message": "Session '8662044208f54095b327ab4c29e1554c' closed with status 1000. Total frames exchanged: 3. session_id is permanently deallocated." }
Errors: 404 if session_id is not in the registry.
End-to-end example: open a session, send a frame, drain, close
import httpx
BASE = "https://npm-package-ws-has-241560546-w-production.up.railway.app"
1. Open a session (requires x402 payment on this call — omitted here for brevity,
see https://docs.x402.org for how to attach a payment header)
r = httpx.post(f"{BASE}/ws-sessions/open", json={ "target_url": "wss://echo.websocket.org", "connect_timeout_seconds": 10.0, }) r.raise_for_status() session_id = r.json()["session_id"]
2. Send a frame (not billed)
httpx.post(f"{BASE}/ws-sessions/{session_id}/send-frame", json={ "payload": '{"action": "ping"}', "frame_type": "text", }).raise_for_status()
3. Drain buffered inbound frames, alert on entropy spikes
ENTROPY_ALERT_THRESHOLD = 1.0
drain = httpx.post(f"{BASE}/ws-sessions/{session_id}/drain-frames", json={ "max_frames": 20, }).json()
for frame in drain["frames"]: if frame["entropy_delta"] > ENTROPY_ALERT_THRESHOLD or not frame["schema_valid"]: print(f"[ALERT] delta={frame['entropy_delta']:.2f} schema_valid={frame['schema_valid']}") print(f" payload={frame'payload'}")
4. Inspect session health before deciding to continue
telemetry = httpx.post(f"{BASE}/ws-sessions/{session_id}/telemetry").json() print(f"schema_violation_rate={telemetry['schema_violation_rate']:.3f} " f"current_entropy={telemetry['current_entropy']:.2f}")
5. Close cleanly
httpx.post(f"{BASE}/ws-sessions/{session_id}/close", json={ "status_code": 1000, "reason": "task complete", }).raise_for_status()
curl example
# Open a session (requires x402 payment — this call alone will return 402
without a valid payment header; see https://docs.x402.org)
curl -X POST https://npm-package-ws-has-241560546-w-production.up.railway.app/ws-sessions/open \ -H "Content-Type: application/json" \ -d '{"target_url": "wss://echo.websocket.org"}'
Send a frame (replace SESSION_ID with the value returned above — not billed)
curl -X POST https://npm-package-ws-has-241560546-w-production.up.railway.app/ws-sessions/SESSION_ID/send-frame \ -H "Content-Type: application/json" \ -d '{"payload": "hello world", "frame_type": "text"}'
Drain buffered inbound frames
curl -X POST https://npm-package-ws-has-241560546-w-production.up.railway.app/ws-sessions/SESSION_ID/drain-frames \ -H "Content-Type: application/json" \ -d '{"max_frames": 5}'
MCP
Connect an MCP-compatible client to the streamable HTTP endpoint at:
https://npm-package-ws-has-241560546-w-production.up.railway.app/mcp
Exposes the same 5 operations as MCP tools (open_websocket_session, send_typed_ws_frame, drain_ws_frame_buffer, inspect_ws_session_telemetry, close_websocket_session), with the same parameters and payment requirement (open_websocket_session requires x402 payment; the other 4 do not).
SDKs
- `sdk_wrappers/sdk.js` — real HTTP client (
axios) against the base URL above. Published to npm as@nexus-mcp-infra/npm-package-ws-has-241560546-weekly-downloads-but-sdk. This is the one to use. - `mcp_wrapper/npm_package_ws_has_241560546_weekly_downloads_but_sdk.py` — do not use. It defaults to a placeholder d