Crypto Price & Market Analysis MCP Server

Crypto Price & Market Analysis MCP サーバー

CoinCap API を使用して、包括的な暗号資産分析を提供する Model Context Protocol（MCP）サーバーです。使いやすいインターフェースを通じて、リアルタイムの価格データ、市場分析、過去の推移を提供します。STDIO と Streamable HTTP の両方のトランスポートに対応しています。

要件

• Node.js 22.14+
• COINCAP_API_KEY による CoinCap API キー

新機能

• 破壊的変更：CoinCap v2 API を削除しました。現在は v3 API のみを使用します。COINCAP_API_KEY が必要です（pro.coincap.io/dashboard で無料プランを利用できます）。
• Streamable HTTP トランスポートを追加（STDIO との互換性も維持）
• STDIO と Streamable HTTP で完全に単独動作し、外部レジストリやランタイムは不要
• 6 つの新しいツール：assets-search、market-global、assets-compare、analysis-candlestick、price-convert、assets-info
• 階層型ツール命名：すべてのツールをカテゴリ接頭辞付きの名前（price-*、market-*、assets-*、analysis-*）に整理
• 出力スキーマ：すべてのツールで、型安全なレスポンスを実現する structuredContent を含む outputSchema を宣言するようになりました
• MCP のベストプラクティス：検証エラー時の isError フラグ、サーバーの説明、asset://{symbol} リソーステンプレート

使い方

以下の設定を Claude Desktop の設定ファイルに追加してください。

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Windows で cmd.exe 経由の起動が必要な MCP クライアントの場合：

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

開発用スクリプト

pnpm watch         # Development: recompile on change (tsc --watch); pair with `node --watch dist/http.js` for HTTP hot reload
pnpm build         # Compile TypeScript → dist/
pnpm format        # Format source files with Prettier
pnpm lint          # Check for lint errors (ESLint + typescript-eslint)
pnpm lint:fix      # Auto-fix lint errors
pnpm types:check   # TypeScript type-check without emitting files
pnpm test          # Run all tests with Vitest
pnpm test:coverage # Run tests with coverage report (Vitest)
pnpm inspector     # Open MCP inspector for interactive debugging

Streamable HTTP サーバーとして実行

MCP over HTTP ストリーミングに対応した環境では、HTTP 経由でサーバーを実行できます。

• 開発中に変更を反映するには、再ビルドして再起動します。

pnpm watch                    # terminal 1: recompile TypeScript
node --watch dist/http.js     # terminal 2: restart the HTTP server on rebuild

• HTTP サーバーをビルドして実行します。

# Build (outputs to dist/)
pnpm build

# Start the HTTP server
pnpm start:http

• STDIO サーバーをビルドして実行します。

# Build (outputs to dist/)
pnpm build

# Start the STDIO server
pnpm start:stdio

サーバーはデフォルトでポート 3000 を使用します（PORT で変更できます）。HTTP 経由で接続するクライアント（例：Claude.ai、Cursor）では、API キーをクエリパラメーターとして渡してください。

http://localhost:3000/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

リモート環境にデプロイする場合：

https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

必須：CoinCap API キー

このサーバーは API キーが必要な CoinCap v3 API を使用します。無料プランを利用できます。

1. pro.coincap.io/dashboard で登録して API キーを取得します。
2. MCP クライアントの設定にキーを追加します。
   • STDIO：COINCAP_API_KEY 環境変数を使用します（上記の使用例を参照）。
   • HTTP：接続 URL の COINCAP_API_KEY クエリパラメーターを使用します（例：/mcp?COINCAP_API_KEY=your_key）。

有効な API キーがない場合、すべてのツールは取得方法を案内するエラーを返します。

リモート MCP クライアント

このサーバーは単独で動作し、クライアントはレジストリやプロキシを介さずに直接接続します。

• Claude Code（ネイティブ Streamable HTTP）：

claude mcp add --transport http mcp-crypto-price "https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY"

• Claude.ai / Claude Desktop：上記のリモート URL を使い、Settings → Connectors から Custom Connector を追加します。
• Cursor や、リモート MCP に対応したその他のクライアント：同じ /mcp URL を指定します。
• stdio のみのクライアント：npx -y mcp-remote "https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY" でリモートエンドポイントに接続するか、COINCAP_API_KEY を設定して npx -y mcp-crypto-price でローカル実行します（上記の「使い方」を参照）。

MCP クライアントを起動すると、暗号資産分析ツールを利用できます。

ツール

price-get

あらゆる暗号資産の現在価格と 24 時間の統計情報を取得します。次の情報が含まれます。

• USD 建ての現在価格
• 24 時間の価格変動
• 取引量
• 時価総額
• 市場順位

price-convert

暗号資産の数量を任意の法定通貨に換算します。

• リアルタイムの価格データと米ドルを基準とした為替レートを使用します
• パラメーター：symbol（例：BTC）、amount（デフォルトは1）、currency（デフォルトはusd）
• 例：2.5 BTCをEURに換算

market-analysis

以下を含む詳細な市場分析を提供します。

• 取引高上位5取引所
• 取引所間の価格差
• 取引高の分布分析
• VWAP（出来高加重平均価格）

market-global

暗号資産市場全体の概要を提供します。

• 全資産の時価総額合計
• 24時間の取引高
• アクティブな暗号資産の数
• ビットコインのドミナンス比率
• 値上がり率上位および値下がり率上位の銘柄

market-rates

法定通貨と暗号資産の米ドルを基準とした換算レートを返します。

• すべての法定通貨のレート（米ドル基準）
• 暗号資産のレート上位10件
• 単一のレートを取得する場合は、オプションのslugパラメーター（例：euro、bitcoin）を指定できます

market-exchanges

24時間の取引高順に、暗号資産取引所の上位を一覧表示します。

• 取引所名、順位、米ドル建ての24時間取引高
• 取引ペア数とマーケットシェア率
• 単一取引所の詳細を取得する場合は、オプションのexchangeIdパラメーター（例：binance）を指定できます
• オプションのlimitパラメーター（1～50、デフォルトは10）

assets-top

時価総額順に暗号資産の上位を一覧表示します。以下の情報を含みます。

• 現在の米ドル建て価格
• 24時間の価格変動
• 時価総額と順位
• 結果数を設定可能（1～50、デフォルトは10）

assets-search

あいまい検索で、名前またはシンボルから暗号資産を検索します。

• シンボル、名前、価格、順位を含む一致した資産を返します
• 結果数を設定可能（1～50、デフォルトは10）
• 例：「bit」を検索すると、Bitcoin、Bitcoin Cash、BitTorrentなどが返されます

assets-info

単一の暗号資産の詳細なメタデータを返します。

• ID、順位、シンボル、名前
• 価格、24時間の変動、時価総額、取引高
• 流通供給量と最大供給量
• VWAP（24時間）

assets-compare

2～5件の暗号資産を並べて比較します。

• 各資産の価格、24時間の変動、時価総額、取引高、順位
• シンボルをカンマ区切りで指定します（例：BTC,ETH,SOL）
• 24時間の変動率に基づき、最もパフォーマンスの高い資産を強調表示します

analysis-historical

以下の機能で過去の価格データを分析します。

• 時間間隔をカスタマイズ可能（5分～1日）
• 最大30日間の過去データに対応
• 価格トレンド分析
• 変動率指標
• 高値／安値の価格範囲

analysis-technical

あらゆる暗号資産の最新のテクニカル指標を返します。

• 期間を指定したSMA（単純移動平均）
• 期間を指定したEMA（指数移動平均）
• RSI（相対力指数）：買われ過ぎ／売られ過ぎ／中立のシグナル付き
• MACD：シグナルライン、ヒストグラム、強気／弱気ラベル付き
• VWAP（出来高加重平均価格、24時間）

analysis-candlestick

暗号資産のOHLCVローソク足データを取得します。

• 各ローソク足の始値、高値、安値、終値、取引高
• 間隔を設定可能（5m、15m、30m、1h、2h、6h、12h、1d）
• 1～30日分の過去のローソク足に対応

リソース

サーバーは以下のMCPリソースを公開します。

• info://server — サーバー名とバージョンのメタデータ
• asset://{symbol} — シンボルで指定した暗号資産の情報（例：asset://BTC）をJSON形式で返します

プロンプト

サーバーは、クライアントが呼び出せる以下のMCPプロンプトを公開します。

プロンプト	引数	説明
analyze-crypto	symbol	包括的な分析：価格、市場、過去のトレンド
compare-cryptocurrencies	symbols	2～5件の暗号資産を並べて比較
market-overview	—	市場全体の概要：指標、上位資産、上位取引所
crypto-conversion	symbol, amount?, currency?	暗号資産の数量を法定通貨に換算
exchange-analysis	symbol	暗号資産の取引所動向を分析
technical-analysis	symbol	総合的なテクニカル分析：指標、ローソク足、トレンド
crypto-screener	query	機会を見つけるために暗号資産を検索・スクリーニング

サンプルプロンプト

• 「ビットコインの現在の価格はいくらですか？」
• 「ETH の市場分析を表示してください」
• 「DOGE の過去 7 日間の価格履歴を教えてください」
• 「BTC を取引している取引所の上位を教えてください」
• 「SOL の価格推移を 1 時間間隔で表示してください」
• 「現在の ETH のテクニカル指標を教えてください」
• 「現在の EUR から USD への為替レートはいくらですか？」
• 「24 時間の取引高が最も多い暗号資産取引所はどこですか？」
• 「『sol』に一致する暗号資産を検索してください」
• 「暗号資産市場の全体像を教えてください」
• 「BTC、ETH、SOL を並べて比較してください」
• 「過去 3 日間の BTC の 1 時間足のローソク足データを表示してください」
• 「2.5 BTC を EUR に換算してください」
• 「Ethereum 資産の詳細情報を取得してください」
• 「暗号資産の価格、市場、過去の推移を網羅した包括的な分析を作成してください」
• 「名前に『bit』が含まれる暗号資産をすべて見つけて、現在の価格を表示してください」
• 「Cardano の時価総額ランキングと流通供給量を教えてください」
• 「上位 3 つのステーブルコインを比較し、取引高が最も多いものを教えてください」
• 「過去 30 日間の Bitcoin のパフォーマンスを日足ローソク足で表示してください」
• 「100 SOL を GBP に換算し、為替レートを表示してください」
• 「市場の全体像を教えてください。世界全体の指標、上昇率上位、BTC のドミナンスを含めてください」
• 「過去 24 時間で最もパフォーマンスが良かった暗号資産と最も悪かった暗号資産は何ですか？」
• 「過去 2 日間の ETH の 15 分足のローソク足データを表示してください」
• 「DeFi トークン（UNI、AAVE、COMP、MKR）を比較してください」
• 「Bitcoin の VWAP と最大供給量はいくらですか？」
• 「レイヤー 2 トークンを検索し、上位の結果を比較してください」

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています