Refund Batch MCP (npm)

An npm-publishable Stdio MCP server for batch refund processing from CSV files.

What it does

The MCP tools are:

• get_runtime_authorization
• batch_refund_from_csv

batch_refund_from_csv:

1. Reads a CSV file whose first three headers are id, uid, and order_id
2. Calls get_tauth2_header to fetch a fresh Authorization header
3. For each row, calls:
   • chargeBack/ignoreTimeLimit
   • maintainRefund
   • order/push
4. Writes a result CSV and returns a structured summary

Package entry

After publishing to npm, the platform can start it with npx.

Suggested platform JSON config

Current package name:

weibo-refund-batch-mcp-kejia3

{
  "mcpServers": {
    "refund-batch": {
      "command": "npx",
      "args": [
        "-y",
        "weibo-refund-batch-mcp-kejia3"
      ]
    }
  }
}

Authorization modes

You now have two ways to run the batch:

1. Pass authorization directly to batch_refund_from_csv
2. Pass seed_authorization and let the server call get_tauth2_header for you

Optional server-side fallback is still supported:

• SEED_AUTHORIZATION
• REFUND_BATCH_SEED_AUTHORIZATION
• config/default-seed-authorization.txt

Current local default seed file is already populated, so this package can fetch a fresh runtime Authorization even when the tool caller does not pass one.

Local test

node ./bin/refund-batch-mcp.js --self-check

printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.0.1"}}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| node ./bin/refund-batch-mcp.js

Tool arguments

{
  "csv_file": "/absolute/path/orders.csv",
  "authorization": "Tauth2 token=\"...\""
}

The CSV header must start with:

id,uid,order_id

Or fetch a fresh token first:

{
  "seed_authorization": "Tauth2 token=\"...\",param=\"uid%3D5058700742\",sign=\"...\""
}

Publish

1. Make sure the package name is available on npm
2. Login with npm login
3. Publish with:

npm publish --access public

Important note

This MCP server is stdio based. The client machine running the MCP host must be able to access:

• wblive.api.weibo.com
• i.fortune.api.weibo.com

And it must be able to read the local CSV file path passed into the tool.