trading-signals-mcp

Trading Signals MCP

一个 MCP 服务，让 Claude、Cursor、LangChain 和任何其他支持 MCP 的 Agent 通过一行调用即可使用 Trading Signals Toolkit：只需 $0.10 的交易前 GO / CAUTION / NO_GO 检查、期货事件风险关卡、交易时段简报，以及基于美国政府宏观数据（BLS、Federal Reserve、Treasury、CFTC）、SEC Form 4 内部人买入和集群买入、Base 代币安全判定及小型量化计算器构建的宏观事件研究。每次工具调用都会通过 x402 使用你控制的钱包自动以 Base 上的 USDC 付款，并设有单次调用支出上限。你也可以通过定价页面获取免费 API 密钥（每月 100 次调用，无需银行卡），试用 HTTP API。

工具和价格

工具	价格（USDC）	返回内容
pre_trade_check	$0.10	为 ES/NQ/CL/GC/ZN 返回一个 GO / CAUTION / NO_GO 判定及通俗易懂的原因：事件关卡 + 交易时段简报 + SEC 内部人活动（+ 可选的 Base 代币判定）
event_gate	$0.01	safeToTrade + 下一项高影响力的美国数据发布（CPI、NFP、PPI、FOMC、Treasury 拍卖）
event_study	$0.02	上次发布时的情况：最近 N 次 CPI、就业、FOMC、PPI、零售销售、GDP 或 PCE 数据发布后 +5/+15/+30/+60 分钟的 ES/NQ/RTY/ZN 走势、百分位数、最大不利走势和建议止损宽度
session_brief	$0.03	即将发布的数据、最新 BLS 数值、Treasury 2y/10y/2s10s、CFTC COT 持仓、假日、判定
token_verdict	$0.02	对 Base ERC-20 的 A-F 判定：所有者、代理合约、流动性、蜜罐模拟、税费
insider_buys	$0.01	某个股票代码对应的 SEC Form 4 公开市场内部人买入
insider_clusters	$0.02	最近 N 天内有多位不同内部人买入的股票代码
vwap_bands	$0.005	根据你的 K 线数据计算 VWAP + 标准差带
opening_range	$0.005	根据你的 K 线数据计算开盘区间、突破状态和目标位
atr_stop	$0.005	Wilder ATR、止损价格和仓位规模
backtest_opening_range_breakout	$0.02	根据你的 K 线数据进行开盘区间突破回测

调用失败（输入有误、上游服务中断）时会返回错误，不会收费。

设置

你需要 Node.js 18.17+，以及一个专用的 Base 钱包私钥，钱包中在 Base 主网上持有几美元的 USDC（无需 ETH；手续费由支付中介支付）。

环境变量	必需	默认值	含义
X402_PRIVATE_KEY	是（调用工具时需要）	–	付款钱包的 0x 前缀私钥
MAX_USD_PER_CALL	否	0.50	单次调用的硬性上限；价格更高的调用会在签名之前被拒绝
TRADING_SIGNALS_BASE_URL	否	https://signals.incomefather.com	API 基础 URL

直接运行：

X402_PRIVATE_KEY=0xYOUR_DEDICATED_WALLET_KEY npx -y x402-trading-signals-mcp

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "trading-signals": {
      "command": "npx",
      "args": ["-y", "x402-trading-signals-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "MAX_USD_PER_CALL": "0.50"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "trading-signals": {
      "command": "npx",
      "args": ["-y", "x402-trading-signals-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "MAX_USD_PER_CALL": "0.50"
      }
    }
  }
}

Claude Code

claude mcp add trading-signals \
  --env X402_PRIVATE_KEY=0xYOUR_DEDICATED_WALLET_KEY \
  --env MAX_USD_PER_CALL=0.50 \
  -- npx -y x402-trading-signals-mcp

LangChain (langchain-mcp-adapters)

# pip install langchain-mcp-adapters langgraph "langchain[anthropic]"
import asyncio, os
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async def main():
    client = MultiServerMCPClient({
        "trading-signals": {
            "command": "npx",
            "args": ["-y", "x402-trading-signals-mcp"],
            "transport": "stdio",
            "env": {**os.environ, "X402_PRIVATE_KEY": os.environ["X402_PRIVATE_KEY"], "MAX_USD_PER_CALL": "0.50"},
        }
    })
    tools = await client.get_tools()
    agent = create_react_agent("anthropic:claude-sonnet-4-5", tools)
    out = await agent.ainvoke({"messages": "Run a pre-trade check for NQ with ticker NVDA."})
    print(out["messages"][-1].content)

asyncio.run(main())

付款方式

每个工具都会调用一个 HTTPS 路由。API 会返回 402 Payment Required，其中包含确切的 USDC 金额；此服务会针对该金额签署 EIP-3009 transferWithAuthorization（仅限 Base 主网上的 USDC，且金额不超过 MAX_USD_PER_CALL），然后重试。已付款结果包含 _payment 字段，其中有结算交易和 BaseScan 链接。未设置 X402_PRIVATE_KEY 时，服务仍会启动并列出工具；调用工具时会返回清晰的“未配置钱包”错误，且不会收费。

安全

• 使用专用的低余额钱包。 新建一个专用钱包，只存入你愿意花费的金额（例如，在 Base 上存入价值 $2–$5 的 USDC），切勿使用持有其他资金的密钥。
• 密钥保留在你的设备上：从环境变量中读取，仅用于在本地签署付款授权，绝不会发送到 API 或记录到日志中。
• 将 MAX_USD_PER_CALL 设为较低值。默认值（$0.50）允许使用所有工具；设为 0.05 可阻止使用 $0.10 的套餐。
• 你的 MCP 客户端配置文件现在包含一个私钥：切勿提交或分享该文件。

开发

npm install
npm run build   # syntax/import check (plain ESM, no compile step)
npm test        # starts the server over stdio, lists tools, checks unpaid/capped errors (spends nothing)

免责声明

仅供参考，不构成投资建议。数据来自公开来源（美国政府机构、SEC EDGAR、Base 主网），可能存在延迟、不完整或错误。你需自行负责交易决策以及你配置的钱包中的资金。

MIT 许可证。