Solana Alpha x402

solana-alpha-x402-mcp

用于 Solana Alpha API 的 stdio MCP 服务（x402 v2，Solana 主网上的 USDC）。

每个付费 HTTP 端点对应一个工具，另有免费的 list_pricing 工具。每个工具都会调用 https://solana-x402-data.netlify.app 上的实时 API（可通过 API_BASE_URL 覆盖）。

工具	端点	价格
list_pricing	—	免费
get_price	/api/price	0.005 USDC
get_news	/api/news	0.005 USDC
get_new	/api/new	0.005 USDC
get_trending	/api/trending	0.01 USDC
get_perps	/api/perps	0.01 USDC
get_rugcheck	/api/rugcheck	0.01 USDC
get_wallet	/api/wallet	0.02 USDC
get_token_report	/api/token-report	0.08 USDC

PayTo（切勿更改）： 3WN7T7VMnRJzjRhKosbaT2oiwuMiBCe6KBfZGiZygv7n

行为

• 未设置 SOLANA_PRIVATE_KEY：工具仍会调用实时 API。遇到 402 时会返回易读的 JSON 结果（包含 price、payTo、network、asset、feePayer），而非直接失败，以便 Agent 了解付款要求。
• **已设置 SOLANA_PRIVATE_KEY：**使用 @x402/fetch + @x402/svm（ExactSvmScheme）自动签名并结算 USDC 付款。可选的 MAX_PRICE_USDC 会拒绝超出上限的调用。
• 此软件包是一个独立的 Node MCP 服务，通过 HTTPS 调用实时 Solana Alpha API，不会嵌入 Netlify Functions。

安装（本地 / 从此代码库安装）

npm install
npm run smoke          # initialize + tools/list + get_price → 402 info (no key, no payment)

发布后的 npm 包名称：solana-alpha-x402-mcp
在此之前，请将 MCP 宿主指向本地入口：node /absolute/path/to/solana-alpha-x402-mcp/src/index.mjs

环境变量

变量	必需	含义
SOLANA_PRIVATE_KEY	否	买方私钥：base58（Phantom/Solana CLI 导出格式）或 JSON 字节数组 […]。切勿提交此密钥。
MAX_PRICE_USDC	否	每次调用的上限（例如 0.02）。标示价格高于上限 → 报错，不会付款。
API_BASE_URL	否	默认值为 https://solana-x402-data.netlify.app

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

启用自动付款（仅使用已注资的临时钱包）：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "SOLANA_PRIVATE_KEY": "YOUR_BASE58_SECRET",
        "MAX_PRICE_USDC": "0.08",
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

此软件包发布到 npm 后，可以使用：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "npx",
      "args": ["-y", "solana-alpha-x402-mcp"],
      "env": {
        "MAX_PRICE_USDC": "0.08"
      }
    }
  }
}

Cursor（mcp.json）

项目或用户 MCP 配置：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],
      "env": {
        "API_BASE_URL": "https://solana-x402-data.netlify.app"
      }
    }
  }
}

或在发布后通过 npx 使用：

{
  "mcpServers": {
    "solana-alpha-x402": {
      "command": "npx",
      "args": ["-y", "solana-alpha-x402-mcp"]
    }
  }
}

发现（HTTP，免费）

实时 API 主机上的公开发现文档：

• /.well-known/mcp.json — 服务卡片 / 安装命令
• /tools.json — Claude/OpenAI 风格的函数架构（含价格）
• /.well-known/agent.json
• /openapi.json
• /llms.txt

安全

• 切勿将真实且已注资的密钥放入 git、截图或聊天记录中。
• 冒烟测试会故意取消设置 SOLANA_PRIVATE_KEY，且绝不会结算付款。
• PayTo 是一个仅用于收款的公开地址，已硬编码为与 API 一致；更改此地址会导致无法与实时服务结算。