Cryptocurrency MCP Server

🚀 Desk3 MCP Server

Desk3暗号通貨データ用の完全互換型MCP (Model Context Protocol)サーバーです。Dify、Claude、Notion MCPなどのクライアントをサポートしています。

✨ 主な機能

• Desk3のすべての暗号通貨データエンドポイントをMCPリソースとツールとして実装
• HTTP、SSE、JSON - RPC 2.0インターフェースをサポート
• uv run desk3_serviceでワンクリックで起動
• Dockerをサポート

📦 インストール

前提条件

• Python 3.12以上
• uvパッケージマネージャー

インストールと実行

uv sync
uv run desk3_service
または
uvicorn src.desk3_service.http_server:starlette_app --host 0.0.0.0 --port 8100

Docker

docker build -t desk3-service .
docker run -e DESK3_API_KEY=your_api_key_here -p 8100:8100 desk3-service

💻 使用例

基本的な使用法

# 推奨: Pythonで直接実行
PYTHONPATH=src python -m desk3_service.http_server
# またはStarlette MCPサーバーバリアントを実行
PYTHONPATH=src python -m desk3_service.starlette_mcp_server

高度な使用法

uv run desk3_service

このモードは、標準入出力を介してMCPを使用する場合にのみ必要です（ほとんどのユーザーにはおすすめしません）。

📚 ドキュメント

リソース

サーバーは以下のリソースを公開しています：

• desk3://gas/suggest
  EIP1559 Gas 提案（EIP1559 Gasの提案を取得します。chainidクエリパラメータが必要です）
• desk3://market/exchangeRate
  法定通貨為替レートリスト（法幣の為替レートリストを取得します）
• desk3://market/mini/24hr
  24時間ミニティッカー（24時間の暗号通貨価格のミニマーケット情報を取得します。symbolパラメータをサポートします。例: ETHUSDT）
• desk3://market/price
  トークン価格情報（リアルタイムのトークン価格情報を取得します。symbolパラメータをサポートします。例: ETHUSDT、BTCUSDT）
• desk3://market/fear - greed
  暗号通貨の恐怖とグリード指数（市場の感情を分析し、賢明な投資決定を支援します。リアルタイムと履歴データをサポートします）
• desk3://market/btc/trend
  BTCトレンド（3ヶ月）（過去3ヶ月のBTCトレンドチャートを取得します。形式: [[日付, 当日の価格, アクティブアドレス数, 新規アドレス数, 取引アドレス数]]）
• desk3://market/eth/trend
  ETHトレンド（3ヶ月）（過去3ヶ月のETHトレンドチャートを取得します。形式: [[日付, 当日の価格, アクティブアドレス数, 新規アドレス数]]）
• desk3://market/altcoin/season
  アルトコインシーズン指数（上位100のアルトコインとビットコインの90日間のパフォーマンスに基づいて、市場がアルトコインシーズンかどうかをリアルタイムで判断し、詳細なチャートと指標を含みます）
• desk3://market/bitcoin/dominance
  ビットコイン支配率（ビットコインが全体の暗号通貨市場の市場価値に占める割合を測定します）
• desk3://market/cycle/indicators
  暗号通貨市場サイクルトップ指標（返されるフィールド: 指標/現在値/24時間変化率%/参考価格/トリガー有無）
• desk3://market/pi - cycle - top
  BTC Piサイクルトップ指標（111DMAと2x350DMAを使用してビットコイン市場のトップを識別します）
• desk3://market/rainbow
  ビットコインレインボー価格チャート（色帯付きの対数増加曲線を使用して市場の感情を説明し、潜在的な買いまたは売りの領域を強調します）
• desk3://market/puell - multiple
  Puell Multiple（Puell Multipleは、毎日の発行量（米ドル）を365日間の平均で割ることにより、ビットコインマイナーの収入を評価します。市場のマイニング圧力を反映します）
• desk3://market/cycles
  シンプルな指標: Puell Multipleステータス/Piサイクルトップステータス/暗号通貨市場サイクルトップ指標（ビットコインの4年サイクルが存在するかどうかを判断し、暗号通貨市場のブルマーケットのトップを識別するのに役立つ指標です）

ツール

• get_suggest_gas
  EIP1559推定Gas情報を取得します（chainidが必要です）
  • chainid: ブロックチェーンネットワークのチェーンID（例: イーサリアムメインネットの場合は1、ポリゴンの場合は137）
• get_exchange_rate
  法定通貨為替レートのリストを取得します
• get_mini_24hr
  24時間のミニティッカー情報を取得します。symbolパラメータをサポートします
  • symbol: BTCUSDT、ETHUSDTなどの形式の取引ペアシンボル。空にするとすべてのシンボルが取得されます
• get_token_price
  リアルタイムのトークン価格情報を取得します。symbolパラメータをサポートします
  • symbol: BTCUSDT、ETHUSDTなどの形式の取引ペアシンボル。空にするとすべてのシンボルが取得されます
• get_fear_greed_index
  恐怖とグリード指数を発見します...（市場の感情を分析し、賢明な投資決定を支援します。リアルタイムと履歴データをサポートします）
• get_btc_trend
  過去3ヶ月のBTCトレンドチャートを取得します...
• get_eth_trend
  過去3ヶ月のETHトレンドチャートを取得します...
• get_altcoin_season_index
  アルトコインシーズン指数ページはリアルタイムの洞察を提供します...
• get_bitcoin_dominance
  ビットコイン（BTC）の支配率は、メトリックです...
• get_cycle_indicators
  暗号通貨市場サイクルトップ指標を取得します（指標/現在値/24時間変化率%/参考価格/トリガー有無のフィールドが返されます）
• get_pi_cycle_top
  Piサイクルトップ指標は、111DMAと2x350DMAを使用してビットコイン市場のトップを識別します
• get_rainbow_chart
  ビットコインレインボーチャートは、色帯付きの対数増加曲線を使用して市場の感情を説明し、潜在的な買いまたは売りの領域を強調します
• get_puell_multiple
  Puell Multipleは、毎日の発行量（米ドル）を365日間の平均で割ることにより、ビットコインマイナーの収入を評価します
• get_cycles
  ビットコインの4年サイクルは存在しますか？暗号通貨市場のブルマーケットのトップを識別するのに役立つ暗号通貨市場サイクル指標を発見します

設定

• 有効なDESK3_API_KEYが必要です（環境変数または.envファイルに設定します）。

起動モード

このプロジェクトは2つの起動モードをサポートしています：

1. HTTP/SSEサーバー（推奨）

0.0.0.0:8100でStarlette HTTP/SSEサーバーを起動し、Dify、Claude、Notion MCPなどと共に使用します。

2. MCP標準入出力サーバー（上級者向け）

CLIまたは高度な統合（HTTP/SSEではない）用の純粋なMCP標準入出力サーバーを起動します。

トラブルシューティング

• uvがインストールされ、PATHに含まれていることを確認してください。
• DESK3_API_KEYが有効であることを確認してください。
• Dockerを使用する場合は、-e DESK3_API_KEY=...でAPIキーを設定してください。