mcp-crypto-toolkit

mcp-crypto-toolkit

AI エージェント向けのリアルタイム暗号資産価格、通貨換算、ガストラッカー、ポートフォリオツール、計算ツール。

Claude に質問：ETH の状況は？ 上位 10 銘柄は？ Base のガス代は？ 私のポートフォリオの価値は？

ホスト版（Claude.ai Custom Connector）： https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp
ドキュメント： DeepWiki · mcpservers.org

機能

• 時価総額、取引高、ランキング、ATH/ATL を含むリアルタイム価格（CoinGecko）
• 暗号資産と法定通貨を換算（必要に応じて Binance P2P 経由の PKR 換算を最適化）
• 名前／シンボルでコインを検索
• 上位コインと値上がり／値下がり銘柄のスナップショット
• 2～5 銘柄を並べて比較
• ポートフォリオの評価（保有資産を一括処理）
• 過去の特定時点および期間のチャート（7d/30d/…）
• USD の送金額見積もり機能付き EVM ガストラッカー
• 取引所手数料とネットワーク手数料を含む損益計算ツール
• トレンド銘柄と Crypto Fear & Greed Index
• 一般的なワークフロー向けの MCP プロンプト
• 設定不要 — API キーは不要です（上限を引き上げる場合は COINGECKO_API_KEY を任意で設定）
• stdio、HTTP、Cloudflare Workers のトランスポート

クイックインストール

npx -y mcp-crypto-toolkit

インストール

Claude Desktop / Cursor / Windsurf

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

ローカルビルド：

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-crypto-toolkit/dist/index.js"]
    }
  }
}

HTTP サーバー

npm run build
npm run start:http
# POST http://localhost:3000/mcp

デプロイ（Smithery / リモート MCP）— 任意

見つけやすくするために、有料ホスティングは必要ありません。 このサーバーはすでに npx -y mcp-crypto-toolkit（stdio）でインストールでき、公式 MCP Registry に掲載されています。Glama と PulseMCP はそこからデータを取り込むため、Fly/Railway の利用料金はかかりません。

Claude.ai Custom Connector や Smithery URL の公開などで、リモート /mcp エンドポイントを使いたい場合に限り、HTTP をデプロイしてください。

Claude.ai カスタムコネクタ

公開ホスト型エンドポイント（Cloudflare Workers）：

https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp

1. Claude.ai で、Settings → Connectors → Add custom connector を選択します
2. 上記の URL を貼り付けます（/mcp を含める必要があります）
3. 10 個のツール（価格取得、換算、トレンドなど）が表示されます

または、独自のサーバーをデプロイ（Cloudflare／Docker／Render）し、https://YOUR-HOST/mcp を使用します。ホスト型サーバーをアップグレードした後もツールが空のまま表示される場合は、コネクタを削除して再度追加してください。

claude_desktop_config.json にリモート URL を指定しないでください。このファイルは stdio 専用です。Claude Desktop をローカルで使用する場合は、次の方法をおすすめします。

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

Cloudflare Workers（推奨のリモート接続先 — 無料プラン）

ウェブ標準の MCP トランスポート（src/worker.ts）を使用します。Docker は不要です。

ライブデモ：ヘルスチェック · MCP

npm install
npx wrangler login
npm run deploy:cf

デプロイ後：https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/health
Claude／Smithery の URL：https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/mcp

ローカルプレビュー：npm run dev:cf

任意のシークレット／変数：

npx wrangler secret put COINGECKO_API_KEY
npx wrangler secret put MCP_API_KEY   # optional: require Bearer / x-api-key on /mcp
# Pro keys also need: wrangler.toml [vars] COINGECKO_PRO = "1"
# Optional: RATE_LIMIT_PER_MINUTE = "60" (default)

CI：リポジトリのシークレットに CLOUDFLARE_API_TOKEN と CLOUDFLARE_ACCOUNT_ID を追加すると、GitHub Release 時（および workflow_dispatch による実行時）に Worker が自動デプロイされます。

Render（無料 — クレジットカード不要）

1. render.com でリポジトリをフォーク／接続します
2. New → Blueprint を選択し、このリポジトリを指定します（render.yaml では Free プランが使用されます）
3. デプロイ後：https://YOUR-SERVICE.onrender.com/health
4. Smithery：https://YOUR-SERVICE.onrender.com/mcp を公開します

無料プランでは約 15 分間アイドル状態が続くとスリープします。最初のリクエストでは、起動まで約 30 秒かかる場合があります。

Docker（ローカル／独自の VPS）

docker build -t mcp-crypto-toolkit .
docker run -p 3000:3000 mcp-crypto-toolkit

有料 PaaS（無料プランでは足りなくなった場合）： Fly.io と Railway は付属の fly.toml／railway.toml で動作しますが、長期的に無料ではありません。

任意の環境変数：COINGECKO_API_KEY、COINGECKO_PRO=1、ガスオラクルのキー（下の表を参照）。

ツール（10 個）

ツール	説明
get_price	リアルタイム価格、市場時価総額、取引量、順位、ATH／ATL
convert	暗号資産 ↔ 法定通貨／暗号資産の換算
search_coin	名前またはシンボルで検索
top_coins	時価総額／取引量上位 N 件、および値上がり／値下がり銘柄
compare_coins	2～5 種類のコインを並べて比較
portfolio_value	保有資産リストの評価額
historical_price	指定日の価格または期間チャートと投資スナップショット
gas_tracker	ガス代と推定送金コスト（USD）
profit_calc	損益、ROI、損益分岐点（手数料とネットワーク手数料を含む）
trending	トレンドのコインと Fear & Greed Index

プロンプト

プロンプト	目的
market-overview	上位コイン、トレンド、市場の動向
whats-trending	トレンドのコインと Fear & Greed
analyze-coin	1 種類のコインの価格と 7 日間の推移
trade-pnl	損益計算の手順を確認
gas-check	ガス代と送金コストに関するアドバイス

プロンプトの例

1. Bitcoin の現在の価格と時価総額は？
2. 「pepe」に一致するコインを検索して
3. 上位 10 種類のコインと、今日値上がりした銘柄を表示して
4. BTC、ETH、SOL を比較して
5. ポートフォリオの評価額を USD で表示して：0.5 BTC と 2 ETH
6. 2024 年 1 月 1 日の ETH の価格は？ そのときの $1000 は今いくらになる？
7. SOL の過去 30 日間の価格範囲を表示して
8. 今の Base のガス代は USD でいくら？
9. 100 で買い、120 で売った。数量 10、手数料 0.1% の場合の利益は？
10. 何がトレンドになっている？ Fear & Greed index は？

開発

git clone https://github.com/nad33mahm3d/mcp-crypto-toolkit
cd mcp-crypto-toolkit
npm install
npm test
npm run build
npm run inspector

任意の環境変数

変数	目的
COINGECKO_API_KEY	CoinGecko のレート制限を緩和します（任意）
COINGECKO_PRO=1	キーを使って Pro ヘッダーを使用します
MCP_API_KEY	Worker のみ：/mcp で Bearer／x-api-key を必須にします
RATE_LIMIT_PER_MINUTE	Worker のみ：デフォルトは 60 です
ETHERSCAN_API_KEY / BSCSCAN_API_KEY / …	ガスオラクルの精度を向上させます
OPTIMISM_API_KEY	Optimism ガスオラクル
PORT	HTTP サーバーのポート（デフォルトは 3000）

ガス API キーがない場合、ガス代の取得元は Blocknative に切り替わり、それも利用できない場合は静的な推定値が使用されます。

コントリビューション

セットアップ、PR のガイドライン、リリースプロセスについては、CONTRIBUTING.mdをご覧ください。

• 行動規範
• セキュリティポリシー
• サポート
• 変更履歴
• DeepWiki — 自動生成されたアーキテクチャドキュメント
• mcpservers.org

リリース（メンテナー向け）

1. 初回のみ：npm パッケージの Settings → Trusted Publisher → GitHub Actions → リポジトリ nad33mahm3d/mcp-crypto-toolkit、ワークフロー publish.yml、環境 release を設定し、npm publish を許可します
2. CHANGELOG.md を更新します
3. タグ vX.Y.Z を付けて GitHub Release を作成します
4. Actions が OIDC 経由で npm に公開します（NPM_TOKEN は不要です。provenance は自動設定されます）

API クレジット

• CoinGecko — 価格、市場、トレンド（無料プラン、キー不要）
• Alternative.me — Fear & Greed Index
• Binance P2P — PKR への換算時の USDT/PKR
• Etherscan ファミリー — オプションのガスオラクル
• Blocknative — ガスのフォールバック

ライセンス

MIT — LICENSEをご覧ください