Cerebrus Pulse

Cerebrus Pulse MCP

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

Cerebrus Pulse 用の MCP サーバーです。AI エージェント向けに、リアルタイムの暗号資産インテリジェンスを提供します。50 以上の Hyperliquid 無期限先物を対象に、テクニカル分析、清算ヒートマップ、市場ストレス、資金調達率などを網羅する 15 個のツールを提供します。

ツール

ツール	説明	コスト
cerebrus_health	ゲートウェイのヘルスチェック	無料
cerebrus_list_coins	利用可能な全ティッカーの一覧（50 以上）	無料
cerebrus_pulse	複数時間枠のテクニカル指標（RSI、EMA、BBands、VWAP、レジーム）	$0.025
cerebrus_sentiment	市場センチメントの集計と恐怖・強欲指数	$0.01
cerebrus_funding	過去の状況を踏まえた資金調達率分析	$0.01
cerebrus_bundle	Pulse、センチメント、資金調達率の統合	$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 設定内に平文で保存されます。

自動支払いには利用上限があり、署名の前に確認されます。

• 1 回の支払いが 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" が返されます。上限値が不正な場合は、上限が解除されるのではなく、自動支払いが無効になります。

ウォレットキーがなくても、有料ツールを情報取得用として利用できます。正確な価格、ネットワーク、受取人が返されるため、呼び出し元のエージェントは任意の方法で支払いを行えます。

pip

pip install cerebrus-pulse-mcp

CLI の使い方

このサーバーには、MCP クライアントを使わずに CLI から直接アクセスするための --json フラグが含まれています。

# 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 のペアで渡せます。

CEREBRUS_WALLET_KEY が設定されていても、CLI はデフォルトで自動支払いを行いません。 呼び出しのたびに新しいプロセスが起動し、CEREBRUS_MAX_SPEND_USD の予算がリセットされるため、 CLI をループ内で実行するスクリプトを予算で停止することはできません。 それでも支払いを行うには CEREBRUS_CLI_AUTOPAY=1 を設定してください。各呼び出しで、 CEREBRUS_MAX_PAYMENT_USD 以下の支払いを 1 回署名する可能性があり、実行する呼び出しの数は スクリプト側で制限する必要があります。

設定

環境変数	説明	必須
CEREBRUS_BASE_URL	API のベース URL（デフォルト：https://api.cerebruspulse.xyz）	いいえ
CEREBRUS_WALLET_KEY	x402 自動支払い用のベースウォレット秘密鍵	いいえ
CEREBRUS_MAX_PAYMENT_USD	自動支払いで署名できる 1 回あたりの最大支払額（デフォルト：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