mcp-coincap-jj

暗号資産価格・市場分析 MCP サーバー（JJ フォーク）

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

📌 このフォークについて

Tracey Russell によるオリジナルの mcp-crypto-price プロジェクトのフォークです。

✅ 変更点：

• CoinCap v3 API を使用するように更新しました（v2 は段階的に廃止されるため）。
• 時間に余裕ができ次第、追加の改善とテストを行う予定です。

💡 CoinCap の「stake-to-API」サブスクリプションモデルに感謝します。ほかの API プロバイダーにもぜひ採用してほしい仕組みです。サブスクリプション疲れは深刻です！

パッケージに関する注意：このプロジェクトは GitHub では wazzan/mcp-coincap-jj としてホストされていますが、npm では @bujaayjaay/mcp-coincap-jj として公開されています。

---

🚀 クイックスタート（初めての方向け）

MCP サーバーを初めて使う方に向けて、手順を追って始めるためのガイドです。

Mac が散らからないよう、Windows 11 VM でテストしました。問題なく動作しました！

Claude Desktop の設定ファイルの場所：

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

---

🟢 Windows セットアップガイド（すべての MCP クライアントで同じ手順です）

1. Node.js をインストールします：（https://nodejs.org/en）
2. Claude Desktop をインストールします。
3. Claude Desktop を設定します：

• ハンバーガーメニュー（左上）を開き、File → Settings → Developer → Edit Config の順に選択します。
• Windows エクスプローラーで claude_desktop_config.json ファイルの場所が開きます。
• お好みのエディターでファイルを編集し、次の設定を追加します（閉じ波括弧をすべて含めてください！）。

同じ手順をほかの MCP クライアントにも使用できます。

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "npx",
      "args": [
        "-y",
        "@bujaayjaay/mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "INPUT_YOUR_API_KEY_HERE"
      }
    }
  }
}

🛠️ 開発者向けセットアップ（ローカルインストール）

プロジェクトをローカルで開発したい開発者やコントリビューター向け：

🖥️ オプション 1：npm からインストール

npm install @bujaayjaay/mcp-coincap-jj

🖥️ オプション 2：クローンしてローカルで実行

git clone https://github.com/wazzan/mcp-coincap-jj.git
cd mcp-coincap-jj
npm install        # Install dependencies
npm run build      # Compile TypeScript code
npm test           # Run tests to verify everything works
npm start          # Starts the MCP server locally

ローカルテスト用の MCP サーバー設定（Windows の例）

• npx でローカル実行する場合は、Claude Desktop（または任意の MCP クライアント）で次の設定を使用します。

{
  "mcpServers": {
    "mcp-coincap-jj": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "C:\\Program Files\\nodejs\\npx.cmd",
        "C:\\Users\\YOUR-WINDOWS-USERNAME\\repos\\github\\mcp-coincap-jj"
      ],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 ヒント：Windows では絶対パスを使用すると、特に複数の環境を実行する際にスムーズに利用できます。

Smithery からのインストール（任意ですが簡単です）

個人で学ぶ機会は少し減りますが、すぐに始めるには最適です！

1. Claude Desktop アプリに Smithery がインストールされていることを確認します。
2. 次のコマンドを実行します。

   smithery install @bujaayjaay/mcp-coincap-jj
   

3. セットアップ中に CoinCap API キーの入力を求められます。

更新：CoinCap API キー

v2 が非推奨になるため、更新された v3 API を使用するには CoinCap から API キーを取得する必要があります。 （https://pro.coincap.io/api-docs/）

⚡使用方法 - ツール

get-crypto-price

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

• USD 建ての現在価格
• 24 時間の価格変動
• 取引量
• 時価総額
• 市場ランキング

get-market-analysis

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

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

get-historical-analysis

以下の情報を使って過去の価格データを分析します。

• カスタマイズ可能な時間間隔（5 分～1 日）
• 最大 30 日分の過去データに対応
• 価格トレンド分析
• ボラティリティ指標
• 高値・安値の範囲

プロンプトの例

• 「Bitcoin の現在価格は？」
• 「ETH の市場分析を見せて」
• 「DOGE の 7 日間の価格履歴を教えて」
• 「BTC を取引している上位の取引所は？」
• 「SOL の 1 時間間隔の価格トレンドを見せて」

プロジェクトの着想

• このプロジェクトは、Tracey Russell 氏の mcp-crypto-price のフォークです。
• Tracey 氏のプロジェクトは、Alex Andru 氏の coincap-mcp プロジェクトに着想を得ています。

ライセンス

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