Crypto Regime MCP

Crypto Regime MCP

signal-api 用のstdio MCP ブリッジです。 Claude Desktop、Claude Code、Cursor、または任意の stdio MCP クライアントを リモートの Streamable HTTP MCP エンドポイントに接続し、次のいずれかの方法でツールの料金を支払います。

• x402：ローカルの EVM ウォレットを使い、Base 上で USDC の支払いに署名します。
• プリペイドクレジット：REST の /v1/* ルートに X-API-Key を送信します。

Signal Messenger ではありません。 signal-api は暗号資産の市場シグナルサービスです。この パッケージは Signal Messenger やそのメッセージアプリとは関係ありません。

概要

• クライアントとは stdio 経由で MCP をやり取りします。
• Streamable HTTP を使って https://signal-api.shicoars.workers.dev/mcp に接続します。
• 入力スキーマを含むリモートツールをローカルに公開します。
• SIGNAL_API_KEY を設定すると、プリペイドクレジットを使い /v1/* 経由で有料ツールを提供し、get_credit_balance を追加します。
• SIGNAL_API_KEY がない場合、x402 の PaymentRequired レスポンスを検出し、Base 上で USDC の支払いに自動署名します。
• x402 モードでは、MAX_SPEND_USDC によってセッションごとの支出上限を設定します。

このブリッジは、stdio MCP のみをサポートし、ネイティブの x402 支払いに対応していないクライアントに便利です。ネイティブの x402 に対応しているクライアントは、リモート URL に直接接続できます。

支払い方法

1. プリペイドクレジット（SIGNAL_API_KEY）

signal-api で購入したクレジットキー（sk_...）を SIGNAL_API_KEY に設定します。ブリッジは次のように動作します。

• /v1/signal、/v1/market-scan、/v1/trend/{asset}、 /v1/regime/{asset}、/v1/indicators/{asset} を X-API-Key ヘッダー付きで呼び出します。
• x402 の支払いには署名せず、EVM_PRIVATE_KEY も必要ありません。
• get_sample には無料の /free/{asset} ルートを使います。
• GET /credits/balance を読み取る get_credit_balance を公開します。
• API が該当するヘッダーを返す場合、課金されたクレジット数と残高を _meta の signal-api/credits に報告します。

両方の変数が設定されている場合、SIGNAL_API_KEY が優先されます。

2. x402（EVM_PRIVATE_KEY）

SIGNAL_API_KEY がない場合、ブリッジは従来どおり動作します。リモートの MCP エンドポイントに接続し、x402 の PaymentRequired 結果を受け取り、 EVM_PRIVATE_KEY を使って Base 上で USDC の支払いに署名し、呼び出しを再試行します。MAX_SPEND_USDC によって、ブリッジがセッションごとに承認できる金額の上限を設定します。

ツールと価格

ツール	x402 の価格	クレジット	説明
list_assets	無料	無料	対応するアセット、プロダクト ID、価格を一覧表示します。最初に呼び出してください。
get_catalog	無料	無料	パラメーター、価格、説明を含む、プロダクトカタログ全体を表示します。
get_sample	無料	無料	1 日遅れの BTC/ETH トレンドとレジームのサンプルです。IP ごとに 1 時間あたり 60 回までです。
get_credit_balance	該当なし	無料	設定された SIGNAL_API_KEY の残りクレジット数です。クレジットモードのみで利用できます。
get_signal	0.01 USDC	1	BTC と ETH を組み合わせた日次トレンドシグナルです。
get_market_scan	0.05 USDC	10	カタログ掲載の全アセットに加え、強気／弱気、RSI、レジームのランキングを表示します。
get_trend	0.005 USDC	1	1 つのアセットの日次 LONG/FLAT トレンドシグナルとエクスポージャーです。
get_regime	0.005 USDC	1	1 つのアセットの強気／弱気／横ばいレジームとボラティリティです。
get_indicators	0.005 USDC	1	RSI14、MACD、ATR14、ボリンジャー %B、リターン、30 日／90 日のレンジです。

x402 のネットワーク：Base メインネット（eip155:8453）、支払い通貨はUSDCです。

クレジットはリクエストごとに課金されます。get_market_scan は 10 クレジット、その他の有料ツールは 1 クレジットです。クレジットが不足している場合は、現在の残高とともに HTTP 402 が返されます。無効なキーの場合は HTTP 401 が返されます。

必要条件

• Node.js 20 以降
• signal-api のクレジットキー、または Base 上に少額の USDC 残高がある EVM ウォレットの秘密鍵
• stdio サーバーに対応した MCP クライアント（Claude Desktop、Claude Code、Cursor、またはその他の MCP 互換クライアント）

インストール

公開済みパッケージを npx で実行します。

npx -y @shicodiez/crypto-regime-mcp

または、グローバルにインストールします。

npm install -g @shicodiez/crypto-regime-mcp

ソースから実行する場合：

git clone https://github.com/Shicodiez/crypto-regime-mcp.git
cd crypto-regime-mcp
npm install

クレジットモードでブリッジを実行します。

SIGNAL_API_KEY=sk_... node src/index.js

または、x402 モードで実行します。

EVM_PRIVATE_KEY=0x... MAX_SPEND_USDC=1 node src/index.js

Windows PowerShell の場合：

$env:SIGNAL_API_KEY = "sk_..."
node src/index.js

$env:EVM_PRIVATE_KEY = "0x..."
$env:MAX_SPEND_USDC = "1"
node src/index.js

プロセスは stdio 経由で通信します。診断情報は stderr に書き込まれます。

クレジットパックの購入

x402 でパックを購入します。スターターパックは 5 USDC で 2,000 クレジット、プロパックは 20 USDC で 10,000 クレジットです。

POST https://signal-api.shicoars.workers.dev/credits/buy/starter

支払いなしで最初のリクエストを送信すると、x402 の要件が PAYMENT-REQUIRED ヘッダーに含まれた HTTP 402 が返されます。x402 に対応した任意のクライアントで Base 上の USDC 支払いに署名し、署名済みのペイロードを付けて同じリクエストを再試行します。

curl -i -X POST https://signal-api.shicoars.workers.dev/credits/buy/starter \
  -H "PAYMENT-SIGNATURE: <signed x402 payment payload>"

成功すると、次のようなレスポンスが返されます。

{
  "key": "sk_...",
  "key_type": "api_key",
  "pack": "starter",
  "credits": 2000,
  "balance": 2000,
  "payer": "0x...",
  "transaction": "0x...",
  "note": "Store this key now. It is not stored and cannot be recovered."
}

key は直ちに保存してください。signal-api には SHA-256 ハッシュのみが保存され、再表示できません。その後、MCP クライアントに SIGNAL_API_KEY=sk_... を設定し、いつでも残高を確認できます。

curl https://signal-api.shicoars.workers.dev/credits/balance \
  -H "X-API-Key: sk_..."

同じヘッダーは /signal、/p/{id}、/v1/* にも直接使用できます。

設定

変数	必須	デフォルト	説明
SIGNAL_API_KEY	次の 2 つのうちいずれか	-	前払いクレジットキー（sk_...）です。クレジットモードと get_credit_balance を有効にします。
EVM_PRIVATE_KEY	次の 2 つのうちいずれか	-	x402 の支払いに署名するための 32 バイトの 16 進数秘密鍵（0x...）です。SIGNAL_API_KEY が設定されている場合は無視されます。
MAX_SPEND_USDC	いいえ	1	x402 モードで、ブリッジがセッションごとに承認できる USDC の上限です。0 に設定すると、有料ツールをブロックします。
SIGNAL_API_MCP_URL	いいえ	https://signal-api.shicoars.workers.dev/mcp	リモート MCP エンドポイントです。
SIGNAL_API_URL	いいえ	MCP URL のオリジン	クレジットモードで使用する REST ベース URL です。
NETWORK	いいえ	eip155:8453	x402 ネットワークです。デフォルトは Base メインネットです。

Claude Desktop

Claude Desktop の設定ファイルを編集します。

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

クレジットモード：

{
  "mcpServers": {
    "crypto-regime": {
      "command": "npx",
      "args": ["-y", "@shicodiez/crypto-regime-mcp"],
      "env": {
        "SIGNAL_API_KEY": "sk_..."
      }
    }
  }
}

x402 モードでは、SIGNAL_API_KEY を EVM_PRIVATE_KEY に置き換え、必要に応じて MAX_SPEND_USDC を設定します。

ファイルを保存した後、Claude Desktop を再起動します。

Claude Code

クレジットモード：

claude mcp add crypto-regime \
  --env SIGNAL_API_KEY=sk_... \
  -- npx -y @shicodiez/crypto-regime-mcp

x402 モード：

claude mcp add crypto-regime \
  --env EVM_PRIVATE_KEY=0x... \
  --env MAX_SPEND_USDC=1 \
  -- npx -y @shicodiez/crypto-regime-mcp

お使いの Claude Code バージョンが x402 支払いを伴うリモート MCP に対応している場合は、代わりにホストされたエンドポイントを直接追加できます。

claude mcp add --transport http crypto-regime \
  https://signal-api.shicoars.workers.dev/mcp

クレジットモードまたは x402 の自動支払いには、上記の stdio ブリッジを使用してください。

Cursor

サーバーを ~/.cursor/mcp.json（グローバル）またはプロジェクト内の .cursor/mcp.json に追加します。クレジットモード：

{
  "mcpServers": {
    "crypto-regime": {
      "command": "npx",
      "args": ["-y", "@shicodiez/crypto-regime-mcp"],
      "env": {
        "SIGNAL_API_KEY": "sk_..."
      }
    }
  }
}

x402 モードでは、SIGNAL_API_KEY を EVM_PRIVATE_KEY に置き換え、必要に応じて MAX_SPEND_USDC を設定します。

ファイルを保存した後、Cursor を再読み込みします。

リモート URL

ホストされた MCP サーバーは次のとおりです。

https://signal-api.shicoars.workers.dev/mcp

トランスポート：Streamable HTTP。

• 無料ツールは認証や支払いなしで利用できます。
• 有料の MCP ツールは x402 の PaymentRequired 結果を返します。
• x402 に対応したクライアントは直接支払うことができます。
• x402 にネイティブ対応していないクライアントは、この stdio ブリッジを x402 モードで使用できます。
• クレジットキーを使用して、X-API-Key で REST ルートを直接呼び出すこともできます。

セキュリティ

• x402 モードでは、専用のウォレットを使用してください。貯蓄やその他の資産を保有するウォレットは使用しないでください。支出してもよい金額だけを入金してください。
• x402 モードでは、MAX_SPEND_USDCを設定してください。デフォルトはセッションあたり1 USDC です。ブリッジは上限を超える支払いを拒否します。
• SIGNAL_API_KEYを保護してください。現金と同様に扱ってください。このキーを持つ人は誰でも、そのクレジットを使用できます。リポジトリにコミットしないでください。
• 秘密鍵とクレジットキーは、MCP クライアントの設定にプレーンテキストで保存されます。そのファイルを保護し、決してコミットしないでください。
• .envファイルやキーを決してコミットしないでください。 同梱の.gitignoreでは、一般的なローカルの秘密ファイルを除外しています。
• 支払いを確認してください。 x402 モードでは、ブリッジは承認された金額と送信先を stderr に記録します。ウォレットの残高と取引履歴を定期的に確認してください。
• ブリッジはEVM_PRIVATE_KEYをローカルの署名ライブラリにのみ渡し、signal-api に送信することはありません。SIGNAL_API_KEYは signal-api にのみ送信されます。

開発

テストを実行します。

npm test

ビルドします（公開するソースの構文をチェックします）。

npm run build

テストスイートでは、セッションの支出トラッカー、USDC 金額の変換、クレジットモードのルートマッピング、クレジットのエラー処理、設定の優先順位をテストします。

ライセンス

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