Yeepay Mcp
@yop-platform
The Yeepay MCP service provides integration with Yeepay services via the Model Context Protocol (MCP).
Overview
What is Yeepay Mcp?
Yeepay Mcp is a Model Context Protocol (MCP) server that integrates with the Yeepay payment platform. It provides tools to create webpage payment orders and query payment order status, enabling AI assistants or MCP‑compatible applications to initiate payments and check their status programmatically. It is intended for developers building payment‑enabled AI workflows or integrations.
How to use Yeepay Mcp?
Install Node.js and pnpm/npm, clone the repository, run npm install (or pnpm install), and copy .env.example to .env with your Yeepay merchant credentials. Then start the service via npm run dev (development) or npm start (production). You can also run it with Docker, invoke via npx, or integrate it into an MCP client like Cline.
Key features of Yeepay Mcp
- Create Yeepay webpage payment orders with required parameters
- Query the status of a Yeepay payment order by order ID
- Supports local development, Docker, and npx execution
- Configurable via environment variables or an
.envfile - Integrates seamlessly with MCP‑compatible tools (e.g., Cline)
Use cases of Yeepay Mcp
- AI assistants creating payment orders for e‑commerce checkouts
- Automated payment status polling in customer service bots
- Server‑to‑server payment orchestration via MCP tools
FAQ from Yeepay Mcp
What parameters are required to create a payment order?
The create_webpage_yeepay_payment tool requires orderId (string), amount (number), goodsName (string), and userIp (string).
How do I query the status of a payment order?
Use the query_yeepay_payment_status tool with the orderId (string) parameter.
What environment variables are needed for configuration?
You must set YOP_PARENT_MERCHANT_NO, YOP_MERCHANT_NO, YOP_APP_PRIVATE_KEY, YOP_APP_KEY, and YOP_NOTIFY_URL in your .env file or in the env field of an MCP client configuration.
Can I run Yeepay Mcp without a local Node installation?
Yes, you can use Docker (docker build -t yeepay-mcp . && docker run -p 3000:3000 --env-file .env yeepay-mcp). After publishing to npm, you can also run it directly via npx yeepay-mcp.
What transport or protocol does Yeepay Mcp use?
The README describes integration via the Model Context Protocol (MCP), with a command‑line interface and environment‑variable configuration. The service listens on a configurable port (default 3000) using HTTP/stdio transport typical of MCP servers.