market-pulse-mcp

小規模で特化したMCP（Model Context Protocol）サーバーです。LLMに暗号資産のライブ市場データを提供します：スポット価格、OHLCVローソク足、オーダーブックのスナップショット、無制限の非粒度（パーペチュアル）契約のファンディングレート、そして一本のテクニカル指標をゼロから計算します。すべてのデータソースが公開済みのキー不要な取引所APIであるため、設定するべきものや作成するアカウントは何もありません。

制作者は Brandon Perez（@remybanks77）で、クリーンなMCPサーバー実装を示すポートフォリオ作品です。型付きPython、最小限の依存関係、そしてpandasやta-libに頼らず自前で書いたインジケータ計算が特徴です。

機能

market-pulse-mcpは、MCP の stdio トランスポート上で6つのツールを公開します：

シンボルは通常の基本（ベース）ティッカーです："BTC"、"ETH"、"SOL"。末尾の -USD や /USD は許容して削除されるので、"BTC-USD" は "BTC" と同等です。

Related MCP server: MCP Crypto Market Data Server

インストール

uvを使う（推奨）

git clone https://github.com/remybanks77/market-pulse-mcp.git
cd market-pulse-mcp
uv venv
uv pip install -e ".[dev]"

pipを使う

git clone https://github.com/remybanks77/market-pulse-mcp.git
cd market-pulse-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

どちらの方法でも market-pulse-mcp コンソールスクリプトがインストールされ、stdio上でサーバーを実行します。

Claude Code での設定

プロジェクトの .mcp.json に追加します（または claude mcp add を実行します）：

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

アクティブな virtualenvにインストールしていない場合は、command をそのvenvのバイナリを直接指すように設定してください。例：/path/to/market-pulse-mcp/.venv/bin/market-pulse-mcp

Claude Desktop での設定

claude_desktop_config.json に追加します（macOS：~/Library/Application Support/Claude/claude_desktop_config.json、Windows：%APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "market-pulse": {
      "command": "/absolute/path/to/market-pulse-mcp/.venv/bin/market-pulse-mcp"
    }
  }
}

保存後、Claude Desktopを再起動します。market-pulse サーバーが、ハンマー/ツールアイコンの下に6つのツールとともに表示されるはずです。

省略

User: What's BTC doing right now, and is it overbought?

Claude: [calls get_price("BTC")]
        [calls compute_indicators("BTC", granularity="1h", limit=200)]

BTC is at $109,842 (bid $109,838 / ask $109,846). On the 1h chart:
  - RSI(14): 68.4, approaching overbought but not there yet (>70)
  - EMA(20) $109,510 above EMA(50) $108,220: short-term trend is bullish
  - ATR(14): $412, so a typical 1h range is roughly 0.4% of price
  - Realized vol (annualized): 47.9%

Not screaming overbought, but RSI is climbing. Want me to check the order
book for signs of resistance near current price, or pull funding rates to
see how leveraged longs are positioned?

User: Check funding, and give me a quick scan of BTC, ETH, and SOL.

Claude: [calls get_funding_rate("BTC")]
        [calls market_summary(["BTC", "ETH", "SOL"])]

Funding on BTC perps (Hyperliquid): 0.0057% per 8h (about 6.2% annualized).
Mildly long-skewed, nothing extreme.

Quick scan:
  BTC   $109,842   RSI 68.4   bullish   funding +6.2%/yr
  ETH   $3,912      RSI 61.2   bullish   funding +4.8%/yr
  SOL   $198.30     RSI 54.9   flat      funding +2.1%/yr

All three trending up on the hourly with positive funding. Nothing at a
extreme RSI level right now.

設計メモ

pandasやta-libでなく、手書きのインジケータ計算を使う理由 このサーバーの主目的は、監査が容易い小さな依存関係であることです：mcp と httpx の2つだけ。4つのインジケータ式のためにpandasを引き込むのは、サーバー本体のロジックよりもはるかに重い依存関係になるでしょう。market_pulse_mcp/indicators.py は、SMA、EMA、ワイルダーのRSI、ワイルダーのATR、そしてログリターンから年率換算した実現ボラティティを、プレーンなPythonリスト上で直接実装しています。また各計メートルを手計算で確認したフィクスチャ値に対するユニットテストで検証しているので、動作の周辺だけでなく計算自体が保証されています。

なぜCoinbaseとHyperliquidなのか どちらもAPIキーなしで完全な市場データを公開しています。Coinbase Exchangeの公開RESTエンドポイント（api.exchange.coinbase.com）はティッカー、ローカス足、オーダーブックを対象とし、Hyperliquidの公開情報API（api.hyperliquid.xyz/info）は1つのmetaAndAssetCtxsリクエストで無制限有訴の契約のファンディングレートとマーク価格の任意性（...）を取得できます。これにより、このプロジェクトは完全に設定ゼロのままです：クローンして、インストールして、実行するだけ。Copyrightサインアップなどはありません。

レート制限への対応: Coinbaseのパブリックティアはレート制限が厳しく（1秒あたり数リクエスト）、exchanges.pyはすべてのリクエストを、指数バックオフ付きの小さなリトライループで包み、HTTP 429と5xxエラーにはリトライします（最大3回の試行、毎回バックオフを2倍にする）が、他の4xxは一時的な状態ではなく時にリクエストが不正であることを示すため即座に終了します。market_summaryはこのリクエストをシンボルごとに順番に呼び出しながらカバレージします。つまり並列ではなく直進するため速度は落ちますが、複数シンボルのスキャンをパブリックのレート制限の十分下に保てます。

エラーハインの哲学 各ツールは取引所クライアントとインジケータ計算からの例外をキャッチし、トレースバックをMCPトランスポートに伝播させずに {"error": "..."} を返します。これにより呼び出し側のモデルは、不透明なツールエラーではなく、処理可能で意味を把握できるメッセージ（再試行や別シンボルのユーザーへの提案など）を受け取れます。

テスト

pytest                    # offline tests only (default; see pyproject.toml)
pytest -m integration     # also hit live Coinbase / Hyperliquid APIs

オフラインスイート（tests/test_indicators.py と tests/test_exchanges.py）は完全な決定論です：インジケータ値は手動で計算したフィクスチャに対して検証し（各テストのコメント参照）、取引所のユーティリティ関数（シンボルの正規化、粒度の解決）はネットワークアクセスのない純粋関数です。統合スイート（tests/test_integration.py）は @pytest.mark.integration がマークされ、実データの価格と外部サービス依存のため既定ではスキップされます。クライアントコードが実際のAPI図形に一致しているかを確認したい場合は、明示的に実行してください。

プロジェクト構造

market_pulse_mcp/
  server.py       # MCPServer-based server: tool definitions, stdio entry point
  exchanges.py    # Coinbase + Hyperliquid HTTP clients, symbol/granularity helpers
  indicators.py   # RSI, EMA, ATR, realized volatility (stdlib only)
tests/
  test_indicators.py   # offline, fixture-based
  test_exchanges.py    # offline, pure-function tests
  test_integration.py  # live API tests, opt-in via -m integration

ライセンス

MITです。詳細は LICENSE を参照してください。