cryptoprice

cryptoprice

cryptoprice は CoinGecko から公開されている暗号資産データを取得します。API の稼働状況、現在のコイン価格、単一コインの全データ、コイン一覧、コインや取引所の検索、過去の市場チャート、世界全体の市場概況、トレンド情報を確認できます。1 つのバイナリでコマンドラインインターフェースと stdio MCP サーバーを提供します。

API キーは不要です。CoinGecko の無料プランでは API キーが不要なため、cryptoprice は何も設定しなくても動作します。デモキーをお持ちの場合は、COINGECKO_API_KEY を設定すると、x-cg-demo-api-key ヘッダーにその値が送信されます。この変数が未設定または空の場合、キーのヘッダーは送信されず、キーがないことによるエラーも発生しません。上流への呼び出しには無料プランのレート制限が適用されます。

インストール

npx @reneturcios/cryptoprice ping

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/cryptoprice

コンテナはデフォルトで MCP サーバーを起動します（下記を参照）。CLI として使用するには、CLI の引数を渡してください。

CLI

cryptoprice ping
cryptoprice price bitcoin,ethereum usd,eur --change
cryptoprice coin bitcoin
cryptoprice coins --platform
cryptoprice search "wrapped bitcoin"
cryptoprice chart ethereum eur 30
cryptoprice global
cryptoprice trending

cryptoprice --version

各コマンドは上流から受け取った JSON ペイロードを出力します。終了コード：成功時は 0、呼び出し失敗時（レート制限などの上流 API エラーを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方の機能を提供します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/cryptoprice mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "cryptoprice": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cryptoprice", "mcp"]
    }
  }
}

ツール

ツール	入力	返される内容
ping	（なし）	CoinGecko API のステータス。
get_price	ids、vs_currencies（必須）、include_24hr_change（任意）	現在の価格。任意で24時間の変動率も含みます。
get_coin	id（必須）	単一コインの全データ：説明、リンク、市場データ。
list_coins	include_platform（任意）	ID、シンボル、名称を含むすべてのコイン。
search_coins	query（必須）	クエリに一致するコイン、取引所、カテゴリ。
get_market_chart	id、vs_currency、days（必須）	過去の価格、時価総額、取引高。
get_global_data	（なし）	時価総額、取引高、ドミナンスの合計。
get_trending	（なし）	トレンドのコイン、NFT、カテゴリ。

すべての呼び出しで、https://api.coingecko.com/api/v3 の CoinGecko API を使用します。ids や id などの識別子には、シンボルではなく CoinGecko ID（例：bitcoin）を指定します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。