API支付钱包

x402 Wallet是一款允许桌面AI客户端原生访问x402 API和付费MCP服务器的电子钱包应用,支持Solana支付。

  • by AlwaysHungrie
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 AlwaysHungrie/x402-wallet

使用说明

x402钱包

演示视频

x402钱包允许现有的桌面AI客户端,如Claude desktop、Cursor等本地访问启用x402的API和付费MCP服务器。

x402钱包是一个电子应用程序,在使用桌面客户端时需要运行。它由一个

  • Solana钱包需要使用SOL和USDC进行设置和融资。
  • 需要在桌面客户端中配置的MCP服务器。

x402钱包运行后,您可以调用任何付费api端点(例如 卖家/api服务器)或访问现有MCP服务器的付费工具(如 卖家/mcp服务器)从桌面客户端内部。

项目设置

本项目由三部分组成:

  1. Api服务器-创建付费Api

这是一个示例express服务器,演示了如何将express api端点货币化。看 卖家/api服务器/README.md 了解更多详情。

使用 requiresSolanaPayment 中间件,您可以将任何现有的api货币化

app.get(
  "/weather",
  (req, res) => {
    res.send({ message: "The weather is sunny" });
  }
);

这样地:

app.get(
  "/weather",
  requiresSolanaPayment("$0.001", "Access to weather data", "solana-devnet"),
  (req, res) => {
    res.send({ message: "The weather is sunny" });
  }
);
  1. MCP服务器-创建付费MCP服务器

这是一个示例MCP服务器,演示了如何将MCP服务器货币化。看 卖家/mcp服务器/README.md 了解更多详情。

一旦设置和配置,像Claude Desktop这样的应用程序将能够使用付费工具(如本例中的乘法工具),如果它决定这样做的话。 但是,该工具只有在同时运行x402钱包并且通过向卖家的钱包发送USDC来使用钱包支付工具时才能成功运行。

使用 registerPaidSolanaTool 中间件,您可以将现有MCP服务器中的任何工具货币化。

const server = new McpServer({
  name: "multiply-server",
  version: "1.0.0",
});

可以这样货币化:

await registerPaidSolanaTool(
  server,
  "multiply",
  {
    price: "$0.01",
    description:
      "Multiply two numbers together.",
  },
  { a: z.number(), b: z.number() },
  { result: z.number().optional() },
  async (args, extra) => {
    const { a, b } = args;
    const result = a * b;
    return {
      content: [
        {
          type: "text",
          text: `The result of multiplying ${a} and ${b} is ${result}`,
        },
      ],
      structuredContent: {
        result: result,
      },
    };
  }
);
  1. x402钱包-这是一个桌面应用程序,允许您运行MCP服务器和api服务器

这是一个电子应用程序,它创建了一个solana钱包和一个MCP服务器,该服务器公开了一个工具,允许代理从桌面客户端调用任何付费api端点(如/seller/api-server)或访问现有MCP服务器(如/seller/MCP server)的付费工具。

看 买家/电子mcp钱包/README.md 了解更多详情。

确切的使用细节可以在 演示视频