Cerebrus Pulse

Cerebrus Pulse MCP

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

适用于 Cerebrus Pulse 的 MCP 服务——为 AI Agent 提供实时加密货币情报。提供 15 种工具，涵盖技术分析、清算热力图、市场压力、资金费率等，支持 50 多种 Hyperliquid 永续合约。

工具

工具	描述	费用
cerebrus_health	网关健康检查	免费
cerebrus_list_coins	列出所有可用的交易代码（50+）	免费
cerebrus_pulse	多时间周期技术指标（RSI、EMAs、BBands、VWAP、市场状态）	$0.025
cerebrus_sentiment	汇总市场情绪 + 恐惧与贪婪指数	$0.01
cerebrus_funding	资金费率分析及历史背景	$0.01
cerebrus_bundle	综合脉冲、情绪和资金费率	$0.05
cerebrus_screener	扫描所有币种，查找重要信号	$0.06
cerebrus_oi	未平仓合约量变化、百分位数和趋势	$0.015
cerebrus_spread	买卖价差 + 滑点估算	$0.015
cerebrus_correlation	BTC 与山寨币相关性矩阵	$0.05
cerebrus_stress	基于跨链套利推导的市场压力指数	$0.02
cerebrus_cex_dex	CEX 与 DEX 价格偏差	$0.02
cerebrus_basis	Chainlink 预言机与 Hyperliquid 基差	$0.02
cerebrus_depeg	通过 Chainlink 监测 USDC 抵押品健康状况	$0.01
cerebrus_liquidations	跨 5 个杠杆等级的清算热力图	$0.03

付费端点使用 x402 小额支付（在 Base 或 Solana 上使用 USDC）。免费工具无需任何配置即可使用。

价格通过 python scripts/check_prices.py --live 与 API 实时 x402 清单 （https://api.cerebruspulse.xyz/.well-known/x402）进行核对，CI 会运行此检查。自动支付收款地址固定值通过 python scripts/check_payto.py --live 与实时 402 响应进行核对，CI 和发布工作流都会运行此检查。

安装

Claude Desktop / Cursor / Windsurf

将以下内容添加到 MCP 配置文件（claude_desktop_config.json、.cursor/mcp.json 等）：

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

若要为付费端点启用 x402 自动支付，请添加钱包密钥。x402 客户端随软件包一同提供，因此同一条 uvx 命令即可完成支付；无需额外安装：

{
  "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"
      }
    }
  }
}

自动支付目前仅支持 Base。CEREBRUS_WALLET_KEY_SOLANA 保留供未来的 Solana 签名器使用——API 目前已接受 Solana 支付，但你需要自行结算这些款项。

请使用仅存有少量 Base 链 USDC 的专用热钱包，切勿使用主钱包：密钥会以纯文本形式保存在 MCP 配置中。

自动支付设有支出限额，并会在签署任何内容之前进行检查：

• 单笔支付不得超过 CEREBRUS_MAX_PAYMENT_USD（默认值：0.10；最贵的工具收费 $0.06）；
• 服务器进程运行期间的总支出不得超过 CEREBRUS_MAX_SPEND_USD（默认值：1.00；重启服务器即可重置）。--json CLI 每次调用都会启动一个新进程，因此此预算无法跨 CLI 调用累计；除非主动启用，否则 CLI 不会自动支付（参见 CLI 使用方法）；
• 只允许使用 Base 链上的 USDC，且只能向 CEREBRUS_ALLOWED_PAYTO 中的地址付款（默认值：已公布的 Cerebrus Pulse Base 地址），以防被劫持或输入错误的 CEREBRUS_BASE_URL 重定向支付。

被拒绝的支付会返回带有原因的 "status": "payment_blocked"；限额格式错误时会禁用自动支付，而不是取消限额。

没有钱包密钥时，付费工具仍可用作信息查询：它们会返回确切的价格、网络和收款方，调用工具的 Agent 可以自行选择付款方式。

pip

pip install cerebrus-pulse-mcp

CLI 用法

该服务包含一个 --json 标志，可在不使用 MCP 客户端的情况下直接通过 CLI 访问：

# List all available CLI tools
cerebrus-pulse-mcp --json

# Free endpoints
cerebrus-pulse-mcp --json health
cerebrus-pulse-mcp --json list-coins

# Paid endpoints (return the payment terms unless CLI auto-pay is on, below)
cerebrus-pulse-mcp --json pulse BTC
cerebrus-pulse-mcp --json funding ETH lookback_hours=48
cerebrus-pulse-mcp --json screener top_n=10
cerebrus-pulse-mcp --json liquidations SOL

参数可以按位置传入（对于 coin），也可以使用 key=value 键值对。

默认情况下，CLI 不会自动付款，即使设置了 CEREBRUS_WALLET_KEY 也是如此。 每次调用都是一个新进程，拥有全新的 CEREBRUS_MAX_SPEND_USD 预算，因此该预算无法阻止在循环中运行 CLI 的脚本。设置 CEREBRUS_CLI_AUTOPAY=1 可允许自动付款：此时每次调用都可能签署一笔最高为 CEREBRUS_MAX_PAYMENT_USD 的付款，而限制调用次数则由你的脚本负责。

配置

环境变量	描述	必填
CEREBRUS_BASE_URL	API 基础 URL（默认值：https://api.cerebruspulse.xyz）	否
CEREBRUS_WALLET_KEY	用于 x402 自动付款的基础钱包私钥	否
CEREBRUS_MAX_PAYMENT_USD	自动付款可签署的单笔最高金额（默认值：0.10）	否
CEREBRUS_MAX_SPEND_USD	每个服务进程的自动付款总额上限（默认值：1.00）；不跨 --json CLI 调用累计	否
CEREBRUS_CLI_AUTOPAY	设置为 1 以允许 --json CLI 自动付款（默认关闭，因为每次 CLI 调用都会重置预算）	否
CEREBRUS_ALLOWED_PAYTO	以逗号分隔的 payTo 地址列表，自动付款可向这些地址付款（默认值：已公布的 Cerebrus Pulse Base 地址）	否
CEREBRUS_WALLET_KEY_SOLANA	预留；尚未实现 Solana 自动付款	否

示例响应

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

开发

git clone https://github.com/0xsl1m/cerebrus-pulse-mcp.git
cd cerebrus-pulse-mcp
pip install -e .

链接

• Cerebrus Pulse — API 文档和指南
• x402 Protocol — HTTP 402 微支付标准
• PyPI Package
• Changelog

许可证

MIT