crypto-price-mcp

price-data-mcp

AI エージェントにリアルタイムの市場価格を提供します。 エージェントが200以上のコインの現在価格、全シンボル一覧、最近の価格履歴を取得できるMCPサーバーです。

LLM の知識はトレーニング時点で固定されるため、「今、BTC はいくらで取引されていますか？」という質問には答えられません。このサーバーがそのギャップを埋めます。市場データのみを返し、取引シグナルの提供や価格動向の予測は行いません。

エージェントでできること

あなた： ビットコインはいくらで取引されていますか？また、ここ数時間でどのように動きましたか？

エージェント （get_price("BTC") と get_candles("BTC", "1h", 6) を呼び出します）： ビットコインは $65,047 です。過去6時間は、出来高が増加する中で $65,020 から $65,132 の範囲で推移しています。

エージェントは、古いトレーニングデータから推測する代わりに、実際の数値を取得します。

クイックスタート

pip install "hyperliquid-price-mcp[mcp]"

MCP クライアント（例：Claude Desktop の設定）に追加します。

{
  "mcpServers": {
    "market-prices": { "command": "hyperliquid-price-mcp" }
  }
}

クライアントを再起動すると、エージェントが4つのツールを使えるようになります。

ツール

ツール	戻り値
get_price("BTC")	{"symbol": "BTC", "price": 65047.5, "as_of": 1786204330859}
get_prices(["BTC","ETH"])	各コインの現在価格。見つからないコインにはその旨を表示します
list_symbols()	価格を取得できるすべてのシンボル（200以上）
get_candles("BTC","1h",100)	最近の OHLCV 履歴（1m ～ 1d）

ローソク足の例：

{"open_ms": 1786201200000, "open": 65104.0, "high": 65132.0,
 "low": 65020.0, "close": 65047.0, "volume": 409.43, "trades": 7014}

通常の Python からも利用できます

from price_data_mcp import prices

prices.get_price("BTC")                # {'symbol': 'BTC', 'price': 65047.5, 'as_of': ...}
prices.get_candles("ETH", "1h", 24)    # last 24 hourly candles
prices.list_symbols()                  # ['AAVE', 'ADA', 'APE', ...]

仕組み

価格データは、公開されているHyperliquidの情報 API から取得します。コアの取得モジュール（price_data_mcp/prices.py）はPython 標準ライブラリのみを使用するため（依存関係なし）、小規模で監査も簡単です。サーバーの実行には mcp エクストラのみが必要です。

テスト

python -m unittest discover -s tests     # network is mocked, runs fully offline

対象範囲

エージェント向けの市場データソースです。価格と履歴を提供します。取引シグナルの提供、価格動向の予測、注文の発注は行いません。

ライセンス

MIT