Machina

machina-mcp

作为 MCP 服务的 Machina。 直接从 Claude Desktop、Cursor 或任何兼容 MCP 的 AI 托管端使用 Machina 基于 x402 的 Agent 服务——无需集成 x402。

每次调用工具都会自动付款。配置一次，按使用量付费。

工具

工具	功能	费用
url_extract	获取任意 URL → 干净的 Markdown	$0.005
scan_python	扫描 Python 代码中的安全漏洞	$0.020
validate_email	验证单个电子邮件地址（语法、MX、SMTP）	$0.007
validate_email_bulk	验证最多 100 个电子邮件地址	$0.500
domain_intel	获取域名的 DNS、WHOIS、SSL 和技术栈信息	$0.050
pdf_inspect	PDF 页数和元数据	免费
pdf_extract	PDF → Markdown（≤50 页）	$0.050
pdf_extract_large	PDF → Markdown（≤200 页）	$0.180

付款使用 Base 上的 USDC（Coinbase 的 L2）。Gas 费用不到一美分。

---

快速开始

1. 安装

pip install machina-mcp

2. 获取钱包并充值

你需要一个在 Base 主网上有少量 USDC 余额的 Ethereum 钱包。

选项 A — 新建钱包（最简单）：

python -c "from eth_account import Account; a = Account.create(); print('Address:', a.address); print('Key:', a.key.hex())"

复制地址，然后通过 Coinbase 或 bridge.base.org 向该地址发送 $1–5 USDC（Base 网络）。

选项 B — 使用现有钱包： 在 MetaMask 中导出私钥：账户详情 → 导出私钥。

3. 设置密钥

export MACHINA_WALLET_KEY=0xYOUR_PRIVATE_KEY

4. 添加到 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "machina": {
      "command": "machina-mcp",
      "env": {
        "MACHINA_WALLET_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

重启 Claude Desktop。8 个 Machina 工具会自动显示。

---

使用示例

连接后，可以向 Claude 提问：

• “提取 https://example.com 中的内容” → 使用 url_extract
• “扫描这段 Python 代码中的安全问题：[粘贴代码]” → 使用 scan_python
• “检查 [email protected] 是否为有效电子邮件地址” → 使用 validate_email
• “获取 openai.com 的 DNS 和 WHOIS 信息” → 使用 domain_intel
• “这个 PDF 有多少页？” → 使用 pdf_inspect（免费）
• “提取 report.pdf 中的文本” → 使用 pdf_extract

---

配置

环境变量	必需	默认值	描述
MACHINA_WALLET_KEY	✅	—	Ethereum 私钥（十六进制，以 0x 开头）
MACHINA_NETWORK	❌	eip155:8453	CAIP-2 网络 ID（Base 主网）
MACHINA_BASE_URL	❌	https://mach402.dev	Machina API 基础 URL

测试网模式（免费，模拟付款）：

export MACHINA_NETWORK=eip155:84532
export MACHINA_BASE_URL=https://mach402.dev  # testnet endpoints at same URL when TESTNET_MODE=true

---

付款方式

1. 你的 Agent 调用 Machina MCP 工具（例如 url_extract）
2. MCP 服务将请求发送到 mach402.dev
3. Machina 返回 402 Payment Required 响应以及确切的 USDC 金额
4. MCP 服务使用你的钱包密钥自动签署并发送 x402 付款
5. Machina 在链上验证付款并返回结果
6. 结果会传回你的 Agent

Agent 不会看到这一切——它只需调用工具并获取结果。

---

独立运行（用于测试）

# Test with MCP Inspector
npx @modelcontextprotocol/inspector machina-mcp

# Or run directly
export MACHINA_WALLET_KEY=0x...
machina-mcp

---

定价

Machina 按次收取费用，使用 Base 主网上的 USDC。付款通过 Coinbase CDP 在链上结算。没有订阅、最低消费或月费。

$5 USDC 余额约可支付 1,000 次 URL 提取或 250 次 Python 代码扫描。

---

链接

• API 文档： https://mach402.dev/docs
• 购买者指南： https://mach402.dev/docs/buyer-guide
• 源代码： https://github.com/NyTerry/machina-mcp
• 问题反馈： https://github.com/NyTerry/machina-mcp/issues

---

许可证

MIT