Agentmetal

Name: Agentmetal
Author: agentmetal

本地服务

github.com/agentmetal开发工具23 周前更新

代码仓库

关于 Agentmetal

Agentmetal 是一个让 AI Agent 发现、创建并管理 Linux VPS 的 MCP 服务，支持通过 SSH 执行命令。付费操作可使用 Base 上的 USDC 或银行卡支付，也提供服务器状态、防火墙和租期管理工具。

主要功能

01查询套餐、位置和附加项价格
02创建并续租 Linux VPS
03查看服务器状态及资源指标
04通过 SSH 以 root 身份执行命令
05读取和管理边缘防火墙规则
06重启、销毁及查看服务器日志

适用场景

01为 Agent 创建临时 Linux 环境
02在已创建的服务器上运行 shell 命令
03检查服务器状态与实时资源指标
04按需调整入站端口规则

MCP 相关

该 MCP 服务将 AgentMetal 的服务器发现、创建、管理和命令执行能力作为工具提供给 Agent。创建与续租等付费工具支持 x402 USDC 支付；部分管理工具需要 AGENTMETAL_API_KEY。

#vps #x402 #usdc #provisioning #infrastructure #ssh #cloud #agent

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}

启动命令npx -y @agentmetal/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@agentmetal/mcp0.3.4stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
os	string	否	可选的 OS 镜像，例如 "ubuntu-24.04"（默认）、"debian-12"、"fedora-44"、"rocky-9"。调用 get_catalog 获取完整列表。
via	string	否	可选的归因标签（例如调用方技能名称）。仅用于分析；不会影响配置。
days	integer	是	租期（整天，1–30）。到期时服务器会自动销毁，除非已延长；需预先支付整个租期的费用。
plan	enum	是	服务器规格／价格档位："nano"（最小、最便宜）、"small" 或 "medium"。请选择满足工作负载需求的最小规格。nano \| small \| medium
ssh_key	string	否	可选的单行 OpenSSH 公钥（例如 "ssh-ed25519 AAAA…"），授权用于 root SSH。省略后，该服务器将无法通过入站 SSH 访问。
managed_key	boolean	否	生成服务器端 SSH 密钥对，在服务器上授权，并仅返回一次私钥；启用 exec_command。仅在服务器端加密存储。

详细介绍

@agentmetal/mcp

MCP 服务将 AgentMetal 封装为工具，让 Agent 无需人工注册即可自行发现 → 付款 → 配置 → SSH 登录 → 运行命令 → 管理 → 续期自己的 Linux 服务（VPS / 云实例）。付费工具通过 x402 v2 签署 USDC 付款（或使用银行卡付款）；其余工具使用普通 HTTP。

工具

共 13 个工具。付费工具会签署 USDC/x402 付款；需要账户的工具要求提供 AGENTMETAL_API_KEY（am_live_…）并且拥有该服务。

工具	付费？	需要账户密钥？	功能
`get_catalog`	—	—	列出套餐、区域和附加项价格（带宽、存储）。免费的发现入口。
`provision_server`	✅ USDC	—	配置 VPS（`plan`、`days`、可选的 `ssh_key`/`via`、`managed_key`）→ ID、IPv4、SSH。设为 `managed_key:true` 时，会在服务端生成密钥对并授权，随后仅返回一次私钥（只以加密形式存储），以启用 `exec_command`。
`get_server`	—	—	查询指定服务 ID 的状态、IPv4、到期时间、带宽和存储
`list_servers`	—	—	列出钱包/账户下的所有服务
`extend_server`	✅ USDC	—	将租期延长 N 天
`destroy_server`	—	✅	立即销毁
`reboot_server`	—	✅	软重启自有服务
`server_logs`	—	✅	无需登录即可查看虚拟机监控程序级别的诊断信息：状态、近期服务商操作、VNC 控制台 URL，以及实时 CPU/磁盘/网络指标（服务商端没有文本启动日志）
`exec_command`	—	✅	通过 SSH 以 root 身份运行 Shell 命令 → exit_code/stdout/stderr。要求服务通过 `managed_key:true` 配置。有限制：超时 1–120 秒，输出上限为 256 KB。
`get_firewall`	—	—	查看主机的边缘防火墙规则。可从主机本身（基于源 IP 的身份验证）调用，也可使用账户密钥调用。
`manage_firewall`	—	—	在主机的边缘防火墙上开放/关闭入站端口（protocol/port/source_ips）。可从主机本身或使用账户密钥调用；具有防止 SSH 锁定的保护。
`claim_account`	—	—	通过电子邮件（经由 AWS SES）发送一次性认领码
`verify_claim`	—	—	使用认领码换取账户 API 密钥。也可同时传入 `wallet` + `wallet_signature` 关联钱包。

附加项（目前为 API 端点，尚未作为单独的 MCP 工具）：额外存储（$0.01/GB/天，附加块存储卷），通过 POST /v1/servers/{id}/storage 使用；额外带宽（超出包含的 20 TB 后，每 TB $2），通过 POST /v1/servers/{id}/bandwidth 使用。

配置（环境变量）

变量	默认值	用途
`AGENTMETAL_BASE_URL`	`https://api.agentmetal.dev`	API 基础 URL
`WALLET_PRIVATE_KEY`	—	用于支付 402 的 `0x…` EVM 密钥。省略后，付费工具会显示清晰的错误消息并失败。
`AGENTMETAL_NETWORK`	`eip155:8453`	CAIP-2 网络（Base 主网）
`AGENTMETAL_MAX_USDC`	`50`	单次请求的 USDC 支出上限
`AGENTMETAL_API_KEY`	—	`am_live_…` 账户密钥；`destroy_server` / `reboot_server` / `server_logs` / `exec_command` 必需

与 Claude Code 搭配使用

// .mcp.json (or claude mcp add)
{
  "mcpServers": {
    "agentmetal": {
      "command": "node",
      "args": ["packages/mcp/src/index.ts"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x…",
        "AGENTMETAL_MAX_USDC": "50"
      }
    }
  }
}

钱包必须持有 Base 网络上的 USDC。支出上限（AGENTMETAL_MAX_USDC）限制单次工具调用可支付的金额；超过上限的 402 请求会在签名前被拒绝。