项目简介

P-Link MCP 服务器是一个符合Model Context Protocol (MCP) 的后端服务,旨在将大型语言模型(LLM)客户端(如ChatGPT、Claude)与P-Link.io的Solana区块链支付系统集成。它允许用户通过自然语言指令,方便地进行资金转移、生成支付链接、查询钱包信息以及支付HTTP 402受保护的URL。

主要功能点

  • 发送资金: 向任何电子邮件、电话号码或Solana钱包地址发送指定金额的资金。如果接收方没有P-Link账户,系统会自动创建一个。
  • 创建支付链接: 生成可定制的支付链接,用于请求他人支付指定金额。支持设置重定向URL、通知邮箱和自定义参数。
  • 查询钱包信息: 获取当前P-Link账户的Solana钱包地址和余额等详细信息。
  • 查看交易历史: 检索与您的Solana钱包相关的交易记录列表。
  • 支付402受保护URL: 使用P-Link账户支付HTTP 402协议保护的URL,并获取受保护内容。
  • 获取交易状态: 查询指定Solana交易ID的详细状态。

安装步骤

  1. 注册P-Link账户并获取API Key:
    • 访问 https://p-link.io 注册账户。
    • 在P-Link网站的API或“发送资金”页面获取您的API Key。
  2. 通过npm或npx安装/运行:
    • 确保您的系统已安装Node.js和npm。
    • 如果您通过 'npx' 运行(推荐,无需手动安装): 在终端中运行以下命令,将 'YOUR_API_KEY' 替换为您的P-Link API Key:
      npx p-link-mcp --apikey=YOUR_API_KEY
    • 如果您从源代码安装并本地构建: a. 克隆仓库(如果尚未克隆):
      bash     git clone https://github.com/paracetamol951/P-Link-MCP.git     cd P-Link-MCP     
      b. 安装依赖:
      bash     npm install     
      c. 构建项目:
      bash     npm run build     
      d. 然后可以运行:'node ./build/stdio.js --apikey=YOUR_API_KEY' 或者通过配置 '.env' 文件。
  3. 配置API Key(可选 '.env' 文件): 除了通过命令行参数 '--apikey' 提供外,您也可以在项目根目录创建一个名为 '.env' 的文件,并在其中添加您的API Key:
    APIKEY=YOUR_API_KEY
    (请将 'YOUR_API_KEY' 替换为您的实际P-Link API Key。)

服务器配置(给MCP客户端用)

MCP服务器是给MCP客户端(如ChatGPT、Claude)使用的。您需要根据您使用的MCP客户端类型,进行相应的配置。

  • 对于Claude桌面版 (Desktop): 编辑 'claude_desktop_config.json' 文件。该文件通常位于:

    • Windows: '%APPDATA%\Claude\claude_desktop_config.json'
    • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json' 在 'mcpServers' 部分添加以下配置。请将 '[replaceWithYourAPIKEY]' 替换为您的P-Link API Key。
      {
      "mcpServers": {
        "caisse": {
          "command": "npx",
          "args": [
            "p-link-mcp",
            "--apikey=[replaceWithYourAPIKEY]"
          ]
        }
      }
    }

    如果您是从源代码安装并本地构建,则需要调整 'command' 和 'args' 以指向您的本地构建文件。例如:

      {
      "mcpServers": {
        "caisse": {
          "command": "node",
          "args": [
            "{{PATH_TO_YOUR_P_LINK_MCP_REPO}}/build/stdio.js"
          ],
          "cwd": "{{PATH_TO_YOUR_P_LINK_MCP_REPO}}",
          "env": {
            "APIKEY": "YOUR_API_KEY"
          }
        }
      }
    }

    (请将 '{{PATH_TO_YOUR_P_LINK_MCP_REPO}}' 替换为您的P-Link-MCP项目根目录的绝对路径,并将 'YOUR_API_KEY' 替换为您的API Key。)

  • 对于ChatGPT (工作区账户): 在ChatGPT的 设置 (Settings) → 连接器 (Connectors) → 创建连接器 (Create Connector) 中,填写以下信息:

    • 'Name': 'P-Link'
    • 'Description': '可以处理支付、发送资金、请求支付'
    • 'MCP Server URL': 'https://mcp.p-link.io/mcp'
    • 'Authentication': 'oAuth' (这将引导您通过P-Link的OAuth流程进行身份验证)

基本使用方法

连接成功后,您可以在ChatGPT或Claude的聊天界面中,直接使用自然语言指令与P-Link MCP服务器交互,例如:

  • “嗨!我的钱包余额是多少?” (查询钱包信息)
  • “能帮我给 https://p-link.io/@phh/0.01?PRODUCT=My_Favorite_shoes&id=888 支付我喜欢的鞋子吗?” (支付402链接)
  • “给 @Paracetamol 发送 0.2$。” (发送资金)
  • “给 [email protected] 发送 0.2$。” (发送资金到邮箱)
  • “能查询一下这笔交易的状态吗?” (查询交易状态)
  • “创建一个10欧元的支付链接。” (创建支付链接)
  • “显示我的交易历史。” (查看交易历史)
  • “支付我朋友发给我的这个P-Link:https://p-link.io/@Paracetamol/0.1。” (支付P-Link)

信息

分类

商业系统