Market Depth Lab

Name: Market Depth Lab
Author: derkcc

作者：derkcc版本 0.2.2i★ –i在你的电脑上运行

注册名称io.github.derkcc/market-depth-lab

安装

概览

作者提供的说明（英文原文）

Read-only Hyperliquid, funding-rate and cross-exchange perpetual spread tools.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 其他

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： MDL_POSITION_INDEX_URL, MDL_POSITION_INDEX_PATH

你需要

npm已安装 Node.js（用于 npx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "npx",
      "args": [
        "-y",
        "market-depth-lab-mcp-server"
      ],
      "env": {
        "MDL_POSITION_INDEX_URL": "your-value",
        "MDL_POSITION_INDEX_PATH": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add market-depth-lab --env MDL_POSITION_INDEX_URL=your-value --env MDL_POSITION_INDEX_PATH=your-value -- npx -y market-depth-lab-mcp-server

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "npx",
      "args": [
        "-y",
        "market-depth-lab-mcp-server"
      ],
      "env": {
        "MDL_POSITION_INDEX_URL": "your-value",
        "MDL_POSITION_INDEX_PATH": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "market-depth-lab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "market-depth-lab-mcp-server"
      ],
      "env": {
        "MDL_POSITION_INDEX_URL": "your-value",
        "MDL_POSITION_INDEX_PATH": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

MDL_POSITION_INDEX_URL env
Optional remote read-only Market Depth Lab position index URL.
MDL_POSITION_INDEX_PATH env
Optional local position-index JSON path. Overrides the remote URL.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 derkcc 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“其他”中的其他服务器比较i

星标数多于此分类中其他 32727 个服务器的 0%
发布到注册中心的时间比此分类中其他 32727 个服务器的 20% 更新
基础检查结果等于或优于此分类中其他 32727 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Market Depth Lab 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.2.2）于3个月前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Foliosio

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新

安装

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211前天更新

安装

Foliosio

作者：foliosio.com

Read your support inbox, tag conversations and save draft replies from your AI agent. Never sends.

在云端运行今天更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Market Depth Lab MCP

Read-only Hyperliquid and cross-exchange market research for AI agents.

🌐 Project website and live dashboards: [marketdepthlab.com](https://marketdepthlab.com)

Every MCP result points back to [Market Depth Lab](https://marketdepthlab.com), where the public dashboards, methodology and related research live.

Market Depth Lab MCP gives Claude, Codex, Cursor and other MCP clients nine structured tools for public Hyperliquid and cross-exchange market data. It does not request a private key, wallet signature, exchange login or permission to trade.

Independent open-source software. Not affiliated with or endorsed by

Hyperliquid. Research information only; not financial advice.

Why this server

Useful on the first call: live HYPE, funding, wallet, TWAP and cross-exchange spread queries.
Read-only by design: no order placement, signing or wallet mutation.
Honest coverage: monitored-address rankings are labeled as a cohort, not a protocol-wide holder census.
Agent-friendly output: each tool returns concise text and stable structuredContent.
Traceable: results include source, time/coverage boundaries and one stateful link to the corresponding Market Depth Lab tool.

Tools

Tool	What it answers
`list_active_hyperliquid_twaps`	Which public TWAP schedules are active, and what is their estimated current notional?
`analyze_hyperliquid_wallet`	What positions, balances, orders, leverage and PnL are visible for this public address?
`calculate_hyperliquid_fees`	What would the estimated fee be for this notional, role and fee tier?
`get_hype_market_snapshot`	What is HYPE worth now, and how do spot and perps compare?
`hyperliquid_summarize_large_trader_positions`	How is the monitored large-trader cohort positioned by market?
`hyperliquid_list_top_position_holders`	Which monitored addresses have the largest positions in one market?
`hyperliquid_list_funding_rates`	Who pays funding now, and what is the exact trailing-24h sum for the returned markets?
`scan_cross_exchange_funding_spreads`	Where is the largest normalized funding difference across Binance USD-M, OKX and Hyperliquid, after a user-supplied cost estimate?
`scan_cross_exchange_perp_price_spreads`	Where do current perpetual best bids and asks diverge across venues, after fee estimates and a visible top-of-book capacity check?

Funding rate and spread engines

The three concepts are deliberately separate:

hyperliquid_list_funding_rates describes the current Hyperliquid main and HIP-3 funding universe, including exact trailing-24h sums for the returned page.
scan_cross_exchange_funding_spreads normalizes one-hour and eight-hour settlement intervals, then compares a lower-funding long leg with a higher-funding short leg. Its annualized number is a comparison, not a forecast.
scan_cross_exchange_perp_price_spreads compares public top-of-book quotes. It reports both entry-fee and round-trip-fee views, plus the smaller visible notional on the selected bid/ask levels. OKX contract counts are converted with the public instrument ctVal before notional is calculated.

The scanners are original TypeScript implementations informed by the read-only monitoring workflow used in Market Depth Lab's local research. They do not vendor or modify the reference Python projects.

Neither scanner places orders. A row is a screening candidate, not proof of executable or risk-free arbitrage. Funding can change; REST snapshots are not simultaneous; Binance/OKX normally settle in USDT while Hyperliquid main perps settle in USDC; and deeper-book slippage, transfers, margin, liquidation, venue access and close-out prices remain outside the estimate.

Requirements

Node.js 20 or newer
Internet access for public Hyperliquid/HypurrScan data
No API key

Install with npm

The public package is market-depth-lab-mcp-server.

Use this configuration in an MCP client that supports local stdio servers:

"mcpServers": { "market-depth-lab": { "command": "npx", "args": ["-y", "market-depth-lab-mcp-server"] } } }

npx downloads the published package and starts the local read-only MCP process. No exchange login, wallet connection or API key is required.

Install from source

git clone https://github.com/derkcc/market-depth-lab-mcp.git

cd market-depth-lab-mcp npm ci npm run build

Use the absolute path to dist/index.js in your MCP client:

"mcpServers": { "market-depth-lab": { "command": "node", "args": ["/absolute/path/to/market-depth-lab-mcp/dist/index.js"] } } }

Use the source checkout when you want to review or modify the implementation; use the npm configuration above for the shortest installation path.

Example prompts

Show the five Hyperliquid markets with the highest absolute current funding.

Include trailing 24h funding and explain who pays whom.

Compare BTC, ETH, SOL and HYPE funding on Binance, OKX and Hyperliquid.

Assume a 24-hour holding period and 12 bps of total round-trip costs. Show the current annualized spread, projected net carry and break-even hours.

Scan BTC, ETH and SOL perpetual top-of-book spreads across Binance, OKX and

Hyperliquid. Use round-trip taker fees, require at least $5,000 visible at the selected levels, and explain every non-execution boundary.

Analyze 0x... on Hyperliquid. Summarize gross exposure, effective leverage,

largest position and recent realized PnL. Do not give trading advice.

Within the monitored cohort, list the top BTC positions and separate longs

from shorts. State the cohort boundary before the ranking.

Estimate round-trip taker fees for a $25,000 tier-zero perpetual position.

Data and privacy

Capability	Data path
HYPE, wallet and Hyperliquid funding	Your local MCP process → public Hyperliquid `info` API
Cross-exchange funding spreads	Your local MCP process → public Binance USD-M, OKX and Hyperliquid market-data APIs
Cross-exchange price spreads	Your local MCP process → public Binance USD-M and OKX book-ticker APIs plus Hyperliquid `l2Book`
Active TWAPs	Your local MCP process → public HypurrScan endpoint, plus Hyperliquid price references
Large positions and top holders	Your local MCP process → Market Depth Lab's rolling read-only position index
Fee calculator	Runs locally; no network request

The server has no analytics or telemetry. A wallet address submitted to analyze_hyperliquid_wallet is sent directly from your machine to the public Hyperliquid API. Position-index calls use https://data.marketdepthlab.com/v1/positions/latest.

Public exchange endpoints can be unavailable in some regions. Both cross-exchange tools expose per-venue available, partial or unavailable coverage and their error messages. They never silently claim that a two-venue or three-venue comparison was complete.

Position-index boundary

Market Depth Lab rotates through a monitored pool of public addresses. The index is useful for cohort-level market structure, but it is:

not a list of every Hyperliquid account;
not a simultaneous snapshot of all monitored addresses;
not proof of who controls an address;
not a recommendation to copy any address.

Every position tool reports the snapshot time, age, monitored-address count, staleness state and coverage boundary.

Configuration

All variables are optional.

Variable	Default	Purpose
`MDL_POSITION_INDEX_URL`	`https://data.marketdepthlab.com/v1/positions/latest`	Remote read-only position index
`MDL_POSITION_INDEX_PATH`	unset	Load a local JSON snapshot instead of the remote index
`MDL_MAX_SNAPSHOT_AGE_HOURS`	`24`	Mark a position snapshot stale after this age
`MDL_REJECT_STALE`	`false`	Return an error instead of labeled stale data
`MDL_HTTP_TIMEOUT_MS`	`15000`	Per-request network timeout

When MDL_POSITION_INDEX_PATH is set, the two position tools do not make a network request. Other live-data tools still use public upstream APIs.

Development

npm ci

npm run check npm test npm pack --dry-run

The test suite performs an in-memory MCP handshake, verifies the nine tool definitions and calls the local fee tool through the protocol. Live upstream smoke tests should be run before each release, but are intentionally excluded from deterministic CI.

Public project links

Website: https://marketdepthlab.com
Live tools: https://marketdepthlab.com
Issues: GitHub Issues
Security: SECURITY.md
Contributing: CONTRIBUTING.md

License

MIT