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