bonuspay-mcp

# BonusPay MCP Installation and Usage Guide ## Requirements - Python 3.8+ - MCP SDK 0.1.0+ ## Download ```sh # Download git clone https://gitlab.platon.network/topos/bonuspay-mcp-server.git # Enter project root directory cd bonuspay-mcp-server ``` ## Set up Environment ```sh # Create virtual environment .venv uv venv # Activate environment source .venv/bin/activate ``` ## Install Dependencies ```sh uv sync ``` ## Supplemental (Install uv on Ubuntu) ```sh # Download and install uv curl -LsSf https://astral.sh/uv/install.sh | sh # Make uv command effective source $HOME/.local/bin/env # Check version uv --version ``` ## Environment Variable Settings ```sh export BONUSPAY_PRIVATE_KEY_PATH="your merchant private key file path" export BONUSPAY_PUBLIC_KEY_PATH="your bonuspay public key file path" export BONUSPAY_PARTNER_ID="your bonuspay partner id (merchant id)" ``` ## Launch mcp server using uv ```sh # (Execute in project root directory) # ${mode}: MCP Server Protocol: stdio, sse, streamable-http # ${network}: Network environment identifier, test for testnet; main for mainnet (if --network parameter is not provided, defaults to testnet) # ${host}: Service IP (if --host is not provided, defaults to 0.0.0.0) # ${port}: Service port (if --port is not provided, defaults to 9998) # ${private-key-path}: Path to BonusPay merchant's RSA private key file (xx.pem) (defaults to value of environment variable BONUSPAY_PRIVATE_KEY_PATH) # ${public-key-path}: Path to BonusPay platform's RSA public key file (xx.pem) (defaults to value of environment variable BONUSPAY_PUBLIC_KEY_PATH) # ${partner-id}: BonusPay merchant's Partner ID (defaults to value of environment variable BONUSPAY_PARTNER_ID) uv run -m bonuspay ${mode} --network ${network} --host ${host} --port ${port} --private-key-path ${private-key-path} --public-key-path ${public-key-path} --partner-id ${partner-id} ``` ## Package and launch mcp server using uvx ```…