VPS和区块链节点购买服务

@easynodexyz/mcp-x402

MCP服务器，用于AI代理通过Easy node的x402 API与USDC on Base购买VPS和区块链节点产品。

概述

该软件包提供了一个模型上下文协议（MCP）服务器，使AI助手能够：

• 列出可用的VPS和区块链节点产品
• 在Base网络上使用USDC购买产品
• 检查订单状态
• 管理正在运行的实例（列表、查看详细信息、续订、重命名）

x402支付流程是自动处理的——代理只需调用工具，支付就会无缝处理。

快速开始

1.安装和设置

npx @easynodexyz/mcp-x402 setup

此交互式向导将：

• 提示输入您的钱包私钥
• 将配置保存到 ~/.easy-node/.env
• 输出要复制的IDE配置

2.配置IDE

选择IDE并添加MCP服务器配置。

作为Claude代码插件安装

/plugin add easynodexyz/mcp-x402

文档

完整文档可在 x402.easy-node.xyz.

IDE配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["@easynodexyz/mcp-x402"]
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

克劳德代码（CLI）

使用添加MCP服务器 /mcp 命令：

claude /mcp add @easynodexyz/mcp-x402 -- npx @easynodexyz/mcp-x402

或者手动添加到您的克劳德代码设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["@easynodexyz/mcp-x402"]
    }
  }
}

配置文件位置：

• macOS/Linux: ~/.claude/settings.json
• 视窗: %USERPROFILE%\.claude\settings.json

光标

添加到光标设置(.cursor/mcp.json 在您的项目或全局配置中）：

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["@easynodexyz/mcp-x402"]
    }
  }
}

配置文件位置：

• 项目: .cursor/mcp.json 在项目根中
• 全球macOS: ~/.cursor/mcp.json
• 全局窗口: %USERPROFILE%\.cursor\mcp.json

VS代码+继续

添加到“继续”配置(~/.continue/config.json):

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["@easynodexyz/mcp-x402"]
        }
      }
    ]
  }
}

其他MCP兼容工具

对于任何与MCP兼容的工具，请使用以下stdio传输配置：

对于环境变量：

{
  "command": "npx",
  "args": ["@easynodexyz/mcp-x402"],
  "env": {
    "EASYNODE_PRIVATE_KEY": "0x...",
    "EASYNODE_API_URL": "..."
  }
}

3.重新启动IDE

重新启动以加载MCP服务器。

4.使用它

问你的AI助手：

• “列出可用的VPS产品”
• “购买VPS-XS产品1个月”
• “检查订单abc123的状态”
• “列出我的实例”
• “获取实例xyz的连接详细信息”
• “将实例xyz续订3个月”

配置

环境变量

配置解析顺序

配置是从多个源加载的（稍后覆盖较早的）：

1. ~/.easy-node/.env -全局配置
2. ./.env -项目级配置
3. 环境变量-最高优先级

替代方案：手动配置

您可以手动配置，而不是运行安装程序：

选项A：在MCP配置中传递env变量

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["@easynodexyz/mcp-x402"],
      "env": {
        "EASYNODE_PRIVATE_KEY": "0x..."
      }
    }
  }
}

选项B：手动创建配置文件

创建 ~/.easy-node/.env:

EASYNODE_PRIVATE_KEY=0x...
EASYNODE_API_URL=https://api.easy-node.xyz/api
EASYNODE_MAX_PAYMENT=1000

MCP工具

产品列表

列出可用的VPS和区块链节点产品，价格为USDC。

参数：

• category （可选）：筛选条件 "vps" 或 "node"

例子：

List all VPS products available for purchase

创建订单

在Base上使用USDC购买产品。自动处理x402付款。

参数：

• productId （必填）：要购买的产品ID
• period （必填）：订阅期（月）
• quantity （可选）：实例数（默认值：1）
• customName （可选）：实例的自定义名称（最多100个字符）

例子：

Purchase 3 months of product abc123

获取订单

检查现有订单的状态。

参数：

• orderId （必填）：要查找的订单ID

例子：

Check status of order xyz789

list_instances

列出钱包拥有的所有实例。

例子：

List all my instances

get_instance

获取包括连接详细信息在内的详细实例信息。

参数：

• instanceId （必填）：要查找的实例ID
• type （必填）：实例类型("node" 或 "vps")

例子：

Get connection details for VPS instance abc123

更新实例

续订现有实例订阅。

参数：

• instanceId （必填）：要续订的实例ID
• period （必填）：续订期（月）
• type （必填）：实例类型("node" 或 "vps")

例子：

Renew my VPS instance abc123 for 3 months

update_custom_name

设置或更新实例的自定义名称。

参数：

• instanceId （必需）：要更新的实例ID
• type （必填）：实例类型("node" 或 "vps")
• customName （必填）：自定义名称（最多100个字符）

例子：

Rename instance abc123 to "my-validator"

安全

• 私钥 以600个权限存储（仅限所有者读/写）
• 最高付款限额 防止意外的大额交易
• 钱包仅签署EIP-3009美元转账授权

x402的工作原理

1. 客服电话 create_order 产品详细信息
2. 第一个请求返回带有支付要求的HTTP 402
3. 客户签署USDC转账授权（EIP-3009）
4. 使用付款签名重试
5. 服务器验证、在链上结算、创建订单
6. 订单退回代理商

故障排除

“EASYNODE_PRIVATE_KEY是必需的”

跑 npx @easynodexyz/mcp-x402 setup 或者设置环境变量。

“付款金额超过最大值”

增加 EASYNODE_MAX_PAYMENT 在您的配置或环境变量中。

“402响应缺少付款要求标头”

API终结点可能不支持x402。检查您是否使用了正确的API URL。

MCP服务器未出现在IDE中

1. 验证配置文件位置是否适合您的操作系统
2. 检查JSON语法是否有效
3. 完全重新启动IDE（而不仅仅是重新加载）
4. 检查IDE日志中的MCP连接错误

贡献

发现错误或有功能请求？请在以下网址打开问题 github/easynodexyz/mcp-x402/issues.

链接

• 简易节点
• x402协议
• MCP文件
• 基础网络

许可证

总线-1.1