crypto-pulse-mcp

crypto-pulse-mcp

Model Context Protocolを通じて、AI アシスタントに読み取り専用の暗号資産市場データを提供します。価格、資金調達率、未決済建玉、DeFi の TVL、ステーブルコインの資金フローについて Claude（または任意の MCP クライアント）に質問すると、公開 API から構造化された回答を取得できます。API キー不要。取引なし。アカウントへのアクセスなし。

ツール	回答できること
get_price	Bybit と Binanceの現物価格、24 時間の変動率／レンジ／出来高、および両者の価格差
get_derivatives	無期限先物の資金調達率（年率換算も）、ベーシス、未決済建玉と出来高に対する比率
get_market_overview	時価総額または出来高上位のコイン、24 時間の変動率、過去最高値からの下落幅、市場の騰落状況（CoinGecko）
get_defi_tvl	TVL 上位のチェーン、上位プロトコルを含む 1 つのチェーン（例：Solana、Stellar）、または 1 つのプロトコル（DefiLlama）
get_stablecoins	時価総額上位の米ドルステーブルコイン、供給量シェア、供給量の 1 日／7 日／30 日の変化。暗号資産市場への資金流入・流出を大まかに示します

接続後に使用できるプロンプトの例：

• 「今、SOL は Binance と比べて Bybit でプレミアムが付いていますか？」
• 「BTC の資金調達率はどうなっていますか？ ロングは過密ですか？」
• 「Stellar の DeFi はどのくらいの規模で、どのプロトコルが上位ですか？」
• 「今週、ステーブルコインの供給量は増えていますか、それとも減っていますか？」

使用例

サーバーに接続した Claude Code での質問（2026 年 10 月 22 日時点のスナップショット）：

SOL は Binance と比べて Bybit でプレミアムが付いていますか？ BTC の資金調達率はどうなっていますか？ Stellar の DeFi はどのくらいの規模ですか？

• SOL（get_price）： プレミアムはありません。Bybit では $103.82、Binance では $103.83 で、差は約 0.01% です。
• BTC の資金調達率（get_derivatives）： ややマイナスで、Bybit では 8 時間あたり -0.0041%（年率約 -4.5%）です。ショートがロングに支払っています。ロングが過密には見えません。
• Stellar DeFi（get_defi_tvl）： TVL は約 $241M で、チェーン中 18 位です。上位プロトコルは Blend Pools V2 で、約 $140M です。

インストール

Node.js 20 以降が必要です。最も簡単な方法は npx で、クローンは不要です：

claude mcp add crypto-pulse -- npx -y crypto-pulse-mcp

Windows では cmd から実行してください（PowerShell では -- が正しく処理されません）。また、Claude Code から起動できるよう npx をラップします：

claude mcp add crypto-pulse -- cmd /c npx -y crypto-pulse-mcp

現在のプロジェクトだけでなく、すべてのフォルダーで使えるようにするには、-s user を追加します。

npm と公式 MCP Registry で公開されています： io.github.markankamaransheogarat-sys/crypto-pulse-mcp。

ソースから実行する場合：

git clone https://github.com/markankamaransheogarat-sys/crypto-pulse-mcp.git
cd crypto-pulse-mcp
npm install
npm run build

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "crypto-pulse": {
      "command": "npx",
      "args": ["-y", "crypto-pulse-mcp"]
    }
  }
}

Windows では "command": "cmd" と "args": ["/c", "npx", "-y", "crypto-pulse-mcp"] を使用してください。

Claude Code

claude mcp add crypto-pulse -- node /absolute/path/to/crypto-pulse-mcp/dist/index.js

stdio サーバーを起動できるその他の MCP クライアントも、同じ方法で動作します。

知っておくとよい詳細

• シンボル。 BTC、ETH/USDT、SOLUSDT、doge-usdt はすべて使用できます。コイン名だけの場合は USDT ペアを意味します。
• 一方の取引所が停止しても失敗ではありません。 get_price と get_derivatives は両方の取引所に並列で問い合わせます。一方に接続できない場合（Binance は一部の国で地域制限されています）でも、もう一方の結果が返され、その旨を示す errors フィールドが含まれます。不明なシンボルは、障害ではなく「上場なし」として報告されます。
• キャッシュ。 無料プランのレート制限内に収めるため、レスポンスは短時間キャッシュされます（取引所のティッカーは 5 秒、CoinGecko は 60 秒、DefiLlama は 5 分）。同時に行われた同一のリクエストは、1 回の呼び出しを共有します。
• 資金調達率の符号。 資金調達率がプラスの場合、ロングがショートに支払います。annualizedFundingPct は今日のレートが 1 年間続くと仮定した値ですが、実際にはそうなりません。予測ではなく、規模の目安としてご覧ください。
• DefiLlama の CEX エントリー（取引所ウォレットの残高）は、チェーンごとのプロトコルランキングから除外されます。
• 金融アドバイスではありません。 これらは公開データのスナップショットであり、数秒から数分遅れていることがあります。

開発

npm run typecheck   # tsc --noEmit over src and tests
npm test            # vitest, all HTTP mocked
npm run build       # compile to dist/
node scripts/smoke.mjs   # live check: starts the built server and calls every tool against the real APIs

構成：src/sources/* はそれぞれ 1 つの API と通信して正規化された形式のデータを返し、src/tools/* はロジックを保持してそれぞれ 1 つの MCP ツールを登録します。src/http.ts は共有クライアント（タイムアウト、回数制限付き再試行、TTL キャッシュ）、src/symbols.ts はシンボルの正規化を担当します。

データソース

Bybit v5 · Binance spot および USDⓈ-M futures · CoinGecko · DefiLlama。本プロジェクトはこれらのいずれとも提携していません。それぞれの利用規約とレート制限を遵守してください。

ライセンス

MIT