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_KEY 设置为从 signal-api 购买的额度密钥（sk_...）。随后，此桥接程序将：

• 使用 X-API-Key 标头调用 /v1/signal、/v1/market-scan、/v1/trend/{asset}、/v1/regime/{asset} 和 /v1/indicators/{asset}。
• 不签署 x402 付款，也不需要 EVM_PRIVATE_KEY。
• 使用免费的 /free/{asset} 路由调用 get_sample。
• 提供 get_credit_balance，用于读取 GET /credits/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 每小时限 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	单个资产的每日 LONG/FLAT 趋势信号和敞口。
get_regime	0.005 USDC	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

以 credit 模式运行桥接程序：

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。

购买 credit 套餐

通过 x402 购买套餐。入门套餐售价 5 USDC，可获得 2,000 个 credit；专业套餐售价 20 USDC，可获得 10,000 个 credit。

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

首次发送未付款的请求时，会返回 HTTP 402，并在 PAYMENT-REQUIRED 标头中提供 x402 要求。使用任何支持 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	二选一	-	预付 credit 密钥（sk_...）。启用 credit 模式和 get_credit_balance。
EVM_PRIVATE_KEY	二选一	-	用于签署 x402 付款的 32 字节十六进制私钥（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 的源站	credit 模式下使用的 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

credit 模式：

{
  "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

credit 模式：

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

如需使用 credit 模式或自动进行 x402 付款，请使用上文的 stdio 桥接程序。

Cursor

将服务添加到 ~/.cursor/mcp.json（全局配置）或项目中的 .cursor/mcp.json。credit 模式：

{
  "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 的客户端可以在 x402 模式下使用此 stdio 桥接程序。
• credit 密钥也可以通过 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。