fwh — CLI & MCP Server

CLI & MCP Server

One static binary that lets both AI Agents and humans operate Flash Warehouse WMS from the command line. macOS, Linux, Windows. Zero runtime dependencies.

45 read-only tools65 write tools110 tools total

What is MCP?

The Model Context Protocol (MCP) is an open protocol that allows AI Agents to call external tools in a standardized way. fwh implements a complete MCP Server — an AI Agent can query inventory, create bills, manage products — like a digital employee who understands your business.

Natural language warehouse operations: "Check the stock for Coca-Cola"

AI Agent automates complex workflows: inquiry → order → receipt → approval

110 MCP tools covering every business scenario

Humans can also use it as a traditional CLI tool

$ fwh mcp

// AI Agent → MCP Protocol → fwh → WMS Backend

Agent: "What beverages do we have in stock?"

fwh: goods_list → API → response

Agent: "Found 4 beverages. Highest stock: Dongpeng Energy (102 units)"

Supported AI Agents

Claude Code

~/.claude/mcp.json

Cursor

~/.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

Safety Model

fwh is the security boundary the backend lacks. Triple protection ensures Agents cannot exceed their authority.

All operations require terminal login first. Agents cannot bypass authentication. Passwords never appear in conversation history.

Tenant Locked

Data scope is locked to the current account at login time, stored in an unexported Go struct field. No parameter can override it.

Writes Opt-in

Write operations are disabled by default. Requires explicit --enable-writes flag. All write tool descriptions start with WARNING:.

110 MCP Tools

Covering purchasing, sales, inventory, finance, staff, BI, and every business module

Goods Management

6 read5 write

Warehouse Management

1 read3 write

Bills (16 types + conversions)

4 read23 write

Suppliers / Customers

1 read5 write

Staff / Roles / Permissions

7 read7 write

BI Dashboard

8 read

Stock Alerts

4 read2 write

Stock Approval / Stocktake

7 read6 write

Retail POS

1 write

System Config

2 read1 write

Print Templates

1 read3 write

AI Assistant

1 read2 write

Goods Classification

2 write

Account Management

1 read3 write

Version Check

2 read

Get Started in 3 Steps

Install fwh

Download the binary for your platform, or build from source

$ terminal

chmod +x fwh-darwin-arm64
mv fwh-darwin-arm64 /usr/local/bin/fwh

Login

$ terminal

fwh login --user 13800138000
# Password: ********
# logged in as 13800138000 (user_id=1)

Configure AI Agent

Add the MCP Server config to your Agent settings

$ terminal

# ~/.claude/mcp.json
{
  "mcpServers": {
    "flash-warehouse": {
      "command": "/usr/local/bin/fwh",
      "args": ["mcp", "--enable-writes"]
    }
  }
}