Cerebrus Pulse MCP

io.github.0xsl1m由 GitHub 账号 0xsl1m 发布v0.5.1更新于 Oct 24, 2026

Real-time Hyperliquid perps intelligence: TA, funding, OI, liquidations. Pay-per-call via x402.

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

本地 MCP 服务器，为助手提供 Hyperliquid 永续合约的实时情报：技术面、资金费率、未平仓量、清算与市场压力，按次付费。

可以做什么
免费检查网关健康状态并列出 50 多个可用的 Hyperliquid 永续合约代码。获取多周期技术指标（RSI、EMA、布林带、VWAP、市场状态）以及含恐惧贪婪指数的聚合情绪。分析带历史背景的资金费率、未平仓量变化与百分位、买卖价差与滑点估算。扫描全部币种寻找最强信号，构建 BTC 与山寨币的相关性矩阵，并比较 CEX 与 DEX 价差、Chainlink 预言机基差和 USDC 脱锚健康度。查看五个杠杆档位的清算热力图，或一次获取技术面、情绪与资金费率的组合数据。
适用场景
适合助手需要 Hyperliquid 永续合约的实时加密衍生品背景信息时使用，例如技术形态、资金费率与未平仓量变化、清算价位或市场压力，用于交易研究或行情解读。免费工具无需任何配置即可做简单的代码列表和健康检查。
运行要求
以 Python 包形式本地运行（PyPI 包名 cerebrus-pulse-mcp），通常用 uvx 启动或通过 pip 安装；需要 Claude Desktop、Cursor 或 Windsurf 等桌面 MCP 客户端。需要访问 Cerebrus Pulse API 的网络连接。付费工具需在 CEREBRUS_WALLET_KEY 中提供 Base 钱包私钥以自动完成 x402 USDC 支付；可选通过 CEREBRUS_MAX_PAYMENT_USD、CEREBRUS_MAX_SPEND_USD 和 CEREBRUS_ALLOWED_PAYTO 设置限额。
安装前请注意
付费工具每次调用都会花费真实的 Base 链上 USDC（约 0.01 至 0.06 美元），使用即产生支出。CEREBRUS_WALLET_KEY 是以明文保存在 MCP 配置中的私钥；README 建议使用只存少量资金的专用热钱包，绝不要用主钱包。自动支付有单笔和单进程总额上限，但 CLI 的预算每次调用都会重置，设置 CEREBRUS_CLI_AUTOPAY=1 后每次调用都可能签名一笔支付。CEREBRUS_WALLET_KEY_SOLANA 为预留项，尚未启用。查询数据会发送给第三方 API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Cerebrus Pulse MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Cerebrus Pulse MCP

mcp-name: io.github.0xsl1m/cerebrus-pulse-mcp

[PyPI] [License: MIT] [Python 3.10+]

MCP server for Cerebrus Pulse — real-time crypto intelligence for AI agents. Provides 15 tools covering technical analysis, liquidation heatmaps, market stress, funding rates, and more across 50+ Hyperliquid perpetuals.

Tools

ToolDescriptionCost
cerebrus_healthGateway health checkFree
cerebrus_list_coinsList all available tickers (50+)Free
cerebrus_pulseMulti-timeframe technicals (RSI, EMAs, BBands, VWAP, regime)$0.025
cerebrus_sentimentAggregated market sentiment + fear/greed$0.01
cerebrus_fundingFunding rate analysis with historical context$0.01
cerebrus_bundlePulse + sentiment + funding combined$0.05
cerebrus_screenerScan all coins for top signals$0.06
cerebrus_oiOpen interest delta, percentile, trend$0.015
cerebrus_spreadBid-ask spread + slippage estimates$0.015
cerebrus_correlationBTC-altcoin correlation matrix$0.05
cerebrus_stressCross-chain arbitrage-derived market stress index$0.02
cerebrus_cex_dexCEX vs DEX price divergence$0.02
cerebrus_basisChainlink oracle vs Hyperliquid basis$0.02
cerebrus_depegUSDC collateral health via Chainlink$0.01
cerebrus_liquidationsLiquidation heatmap across 5 leverage tiers$0.03

Paid endpoints use x402 micropayments (USDC on Base or Solana). Free tools work without any configuration.

Prices are checked against the API's live x402 manifest (https://api.cerebruspulse.xyz/.well-known/x402) with python scripts/check_prices.py --live, which CI runs. The auto-pay payee pin is checked against a live 402 with python scripts/check_payto.py --live, which CI and the release workflow run.

Install

Claude Desktop / Cursor / Windsurf

Add to your MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):

json
{  "mcpServers": {    "cerebrus-pulse": {      "command": "uvx",      "args": ["cerebrus-pulse-mcp"]    }  }}

To enable automatic x402 payments for paid endpoints, add a wallet key. The x402 client ships with the package, so the same uvx command pays; there is no extra to install:

json
{  "mcpServers": {    "cerebrus-pulse": {      "command": "uvx",      "args": ["cerebrus-pulse-mcp"],      "env": {        "CEREBRUS_WALLET_KEY": "your-base-wallet-private-key",        "CEREBRUS_WALLET_KEY_SOLANA": "your-solana-wallet-private-key"      }    }  }}

Automatic payment currently covers Base only. CEREBRUS_WALLET_KEY_SOLANA is reserved for a future Solana signer — the API accepts Solana today, but you would need to settle those payments yourself.

Use a dedicated hot wallet that holds a few dollars of USDC on Base, never a main wallet: the key sits in plain text in the MCP config.

Auto-payment has spend limits, checked before anything is signed:

  • no single payment above CEREBRUS_MAX_PAYMENT_USD (default 0.10; the priciest tool costs $0.06);
  • no more than CEREBRUS_MAX_SPEND_USD in total while the server process runs (default 1.00; restart the server to reset it). The --json CLI starts a new process on every call, so this budget cannot span CLI calls, and the CLI does not auto-pay unless you opt in (see CLI Usage);
  • only USDC on Base, and only to an address in CEREBRUS_ALLOWED_PAYTO (default: the published Cerebrus Pulse Base address), so a hijacked or mistyped CEREBRUS_BASE_URL cannot redirect payments.

A refused payment returns "status": "payment_blocked" with the reason; a malformed limit disables auto-payment rather than lifting the limit.

Without a wallet key, paid tools still work as discovery: they return the exact price, network, and recipient so the calling agent can pay however it likes.

pip

bash
pip install cerebrus-pulse-mcp

CLI Usage

The server includes a --json flag for direct CLI access without an MCP client:

bash
# List all available CLI toolscerebrus-pulse-mcp --json
# Free endpointscerebrus-pulse-mcp --json healthcerebrus-pulse-mcp --json list-coins
# Paid endpoints (return the payment terms unless CLI auto-pay is on, below)cerebrus-pulse-mcp --json pulse BTCcerebrus-pulse-mcp --json funding ETH lookback_hours=48cerebrus-pulse-mcp --json screener top_n=10cerebrus-pulse-mcp --json liquidations SOL

Arguments can be passed positionally (for coin) or as key=value pairs.

The CLI does not auto-pay by default, even with CEREBRUS_WALLET_KEY set. Every call is a new process with a fresh CEREBRUS_MAX_SPEND_USD budget, so the budget cannot stop a script that runs the CLI in a loop. Set CEREBRUS_CLI_AUTOPAY=1 to let it pay anyway: each call may then sign one payment of up to CEREBRUS_MAX_PAYMENT_USD, and limiting how many calls run is up to your script.

Configuration

Environment VariableDescriptionRequired
CEREBRUS_BASE_URLAPI base URL (default: https://api.cerebruspulse.xyz)No
CEREBRUS_WALLET_KEYBase wallet private key for x402 auto-paymentNo
CEREBRUS_MAX_PAYMENT_USDLargest single payment auto-pay may sign (default: 0.10)No
CEREBRUS_MAX_SPEND_USDTotal auto-pay may sign per server process (default: 1.00); does not span --json CLI callsNo
CEREBRUS_CLI_AUTOPAYSet to 1 to let the --json CLI auto-pay (default: off, because the budget resets on every CLI call)No
CEREBRUS_ALLOWED_PAYTOComma-separated payTo addresses auto-pay may pay (default: the published Cerebrus Pulse Base address)No
CEREBRUS_WALLET_KEY_SOLANAReserved; Solana auto-payment not yet implementedNo

Example Response

bash
$ cerebrus-pulse-mcp --json health{  "status": "ok",  "engine": "available",  "kill_switch": "enabled",  "version": "1.2.0"}

Development

bash
git clone https://github.com/0xsl1m/cerebrus-pulse-mcp.gitcd cerebrus-pulse-mcppip install -e .

Links

License

MIT

来源：README.md，提交 e8c6ca2

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.5.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分