Vending MCP Server

A simple MCP server for parsing vending machine transaction queries using npx.

Features

• Parse natural language queries about vending transactions
• Extract trade numbers, product names, dates, amounts
• Generate API calls for transaction photos
• Support for both English and Chinese queries

Quick Start with npx

# Install dependencies
npm install

# Test locally
node index.js

# Or run with npx after publishing
npx @gujiahe233/vending-mcp-server

MCP Configuration

Option 1: Using npx (Recommended)

{
  "mcpServers": {
    "vending-transaction": {
      "type": "stdio",
      "command": "npx",
      "args": ["@gujiahe233/vending-mcp-server"]
    }
  }
}

Option 2: Using npm exec (Alternative)

{
  "mcpServers": {
    "vending-transaction": {
      "type": "stdio",
      "command": "npm",
      "args": ["exec", "@gujiahe233/vending-mcp-server"]
    }
  }
}

Note: Both methods work identically. Use npx if available, or npm exec as a fallback.

Example Queries

• "Show me trade number 1721202505085467000010100569"
• "Find my Coca-Cola purchases from last week"
• "查询我的可乐购买记录" (Chinese)
• "Show me transactions over 5 yuan"

Tools Available

1. parse_transaction_query - Parse natural language queries
2. get_transaction_photo - Get transaction photos by trade number

Publishing to npm

# Login to npm
npm login

# Publish the package
npm publish

Then users can run it with:

npx vending-mcp-server

Simple and clean!