Máy chủ @blockchain0x/mcp cung cấp cho một máy chủ MCP năm công cụ ví tác nhân: đọc một ví, liệt kê các ví, kiểm tra một giao dịch, gửi một khoản thanh toán USDC và giải quyết một hóa đơn x402. Chạy nó với npx @blockchain0x/mcp (khóa của bạn ở lại trên máy của bạn) hoặc chỉ định vào URL được lưu trữ. Riêng biệt, gói này xuất khẩu requirePayment để bạn có thể đặt giá cho các công cụ MCP của riêng mình với một thách thức x402 402.

Hai cách để chạy nó. Không cần cài đặt cho cái được lưu trữ.

Chạy nó cục bộ qua stdio với npx (khóa của bạn ở lại trên máy của bạn), hoặc chỉ định bất kỳ máy chủ MCP nào tại URL HTTP Streamable được lưu trữ và truyền khóa dưới dạng mã thông báo Bearer. Cả hai đều thả thẳng vào cấu hình MCP của máy chủ. Node 20+ cho đường dẫn cục bộ.

{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["-y", "@blockchain0x/mcp"],
      "env": {
        "BLOCKCHAIN0X_API_KEY": "sk_live_...",
        "BLOCKCHAIN0X_API_BASE_URL": "https://api.blockchain0x.com"
      }
    }
  }
}

{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

BLOCKCHAIN0X_API_KEY là một khóa sk_test_ testnet hoặc sk_live_ mainnet từ bảng điều khiển của bạn; BLOCKCHAIN0X_API_BASE_URL mặc định là https://api.blockchain0x.com. Máy chủ chuyển tiếp khóa của bạn đến backend và không lưu trữ gì, vì vậy phạm vi và giới hạn trên khóa đó chính xác là những gì đại lý có thể làm. Năm công cụ mà nó cung cấp: get_wallet, list_wallets, get_transaction, send_payment và settle_payment_request.

Đánh dấu người gọi đã thanh toán khi webhook đến.

Khi một khoản thanh toán được xác nhận, Blockchain0x sẽ POST một sự kiện payment.received đã ký đến webhook URL của bạn. Xác minh bằng webhooks.verify từ Node SDK, sau đó ghi nhận rằng bên gọi đã thanh toán trong bất kỳ kho lưu trữ nào bạn đang dùng. Không có receipt cache đi kèm để cấu hình - phần đó do bạn tự quản, nghĩa là không có hạ tầng phát sinh bất ngờ.

import express from "express";
import { webhooks } from "@blockchain0x/node";

const app = express();
// Capture the RAW body. The HMAC is over the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  if (!result.ok) return res.status(400).json({ code: result.code });

  if (result.eventType === "payment.received") {
    // Mark this payer paid however you like - a DB row, a Redis key, your call.
    markPaid(result.eventId);
  }
  res.status(200).send("ok");
});

webhooks.verify thực hiện HMAC-SHA256 trong thời gian không đổi và trả về một liên minh phân biệt, vì vậy bạn phân nhánh trên result.ok mà không cần try/catch. Đọc thân thô, không phải bản sao đã phân tích, vì chữ ký bao trùm các byte chính xác. Các sự kiện được gửi là payment.received, payment.sent, wallet.deployed, và webhook.test; một khoản thanh toán vào ví của bạn là payment.received. Nơi bạn duy trì 'người gọi này đã thanh toán' - một hàng trong cơ sở dữ liệu, một khóa Redis, một bản đồ trong bộ nhớ cho một quy trình đơn - là tùy thuộc vào bạn.

Năm cạm bẫy cụ thể về MCP cần tránh.

Những điều này đến từ các nhà điều hành đang chạy các máy chủ MCP trả phí trong sản xuất. Hầu hết liên quan đến kiến trúc bộ nhớ đệm và định dạng lỗi cụ thể của giao thức MCP.