Crypto Trending MCP Server

Crypto Trending MCP Server

CoinGecko で最新のトレンドトークンを追跡・監視し、人気の高い暗号資産に関するリアルタイムの分析情報を提供する MCP サーバーです。

特長

• ツール：get_trending_md_doc
  CoinGecko のトレンドページ全体を Markdown ドキュメントとして返します。Rank、Name、Symbol、Price、1h Change、24h Change、7d Change、24h Volume、Market Cap の列を含む、トレンド入りした暗号資産の表が含まれます。

• プロンプト：parse_trending_md_doc
  MCP クライアントが Markdown ドキュメントからトレンド銘柄の表を抽出し、LLM で解析できるようにガイドします。価格上昇率がプラスの銘柄の特定や、時価総額によるランキングなどの分析に対応しています。

• シームレスな連携
  Claude Desktop での使用を想定しており、MCP のツールとプロンプトを利用して、自然言語でトレンド中の暗号資産データを分析できます。

• 軽量で拡張可能
  最小限の依存関係とシンプルなアーキテクチャで構築されているため、簡単に拡張またはデプロイできます。

インストール

前提条件

• Python 3.10 以降
• Node.js（Playwright のブラウザー依存関係用）
• Claude Desktop（任意。MCP クライアントでのテスト用）

手順

1. リポジトリをクローンします：

   git clone https://github.com/kukapay/crypto-trending-mcp.git
   cd crypto-trending-mcp
   

2. uv で依存関係をインストールします：

   uv sync
   playwright install
   

使用方法

Claude Desktop との連携

1. Claude Desktop を設定します：

   • 設定ファイルを編集します：

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

   • サーバー設定を追加します：

     {
       "mcpServers": {
         "crypto-trending": {
           "command": "uv",
           "args": [
             "--directory",
             "/absolute/path/to/crypto-trending-mcp",
             "run",
             "main.py"
           ]
         }
       }
     }
     

     /absolute/path/to/crypto-trending-mcp を main.py の絶対パスに置き換えます。

2. Claude Desktop を再起動します：

   • Claude Desktop を終了して、再度開きます。
   • 入力ボックスにハンマーアイコン（🔨）が表示され、MCP ツールが利用可能になっていることを確認します。

3. サーバーを操作します：

   • 次のような自然言語の質問をします：
     • 「24 時間の価格変動がプラスのトレンド中の暗号資産は何ですか？」
     • 「時価総額上位 3 位のトレンド銘柄を表示してください。」
   • Claude は get_trending_md_doc ツールと parse_trending_md_doc プロンプトを使用して、データを取得・分析します。

出力例

get_trending_md_doc ツールは、次のような Markdown ドキュメントを返します：

# Trending Crypto

...

| Rank | Name        | Symbol | Price      | 1h Change | 24h Change | 7d Change | 24h Volume      | Market Cap         |
|------|-------------|--------|------------|-----------|------------|-----------|-----------------|-------------------|
| 1    | Bitcoin     | BTC    | $67,890.12 | +0.45%    | +2.34%     | +10.12%   | $45,123,456,789 | $1,345,678,901,234 |
| 2    | Ethereum    | ETH    | $2,456.78  | -0.12%    | -1.12%     | +5.67%    | $20,987,654,321 | $295,123,456,789   |
| 3    | Solana      | SOL    | $167.45    | +0.89%    | +5.67%     | +15.34%   | $3,456,789,123  | $78,901,234,567    |

...

*Data from CoinGecko*

parse_trending_md_doc プロンプトは、LLM が表を抽出して、次のような構造化された出力を生成できるようにガイドします：

[
  {
    "rank": 1,
    "name": "Bitcoin",
    "symbol": "BTC",
    "price": "$67,890.12",
    "change_1h": "+0.45%",
    "change_24h": "+2.34%",
    "change_7d": "+10.12%",
    "volume_24h": "$45,123,456,789",
    "market_cap": "$1,345,678,901,234"
  },
  ...
]

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については LICENSE ファイルを参照してください。