CLI & MCP Server
一个静态二进制文件，让 AI Agent 和人类都能通过命令行操作闪仓 WMS。支持 macOS、Linux、Windows，无运行时依赖。
什么是 MCP？
Model Context Protocol (MCP) 是一个开放协议，允许 AI Agent 以标准化方式调用外部工具。fwh 实现了完整的 MCP Server，AI Agent 可以直接查询库存、创建单据、管理商品——就像一个懂业务的数字员工。
// AI Agent → MCP Protocol → fwh → WMS Backend
Agent: "查一下库存里有哪些饮料"
fwh: goods_list → API → response
Agent: "找到 4 种饮料，库存最多的是东鹏特饮 (102 件)"
支持的 AI Agent
~/.claude/mcp.json~/.cursor/mcp.json~/.codeium/windsurf/mcp_config.json安全模型
fwh 是后端缺失的安全边界。三重防护确保 Agent 不会越权操作。
所有操作必须先在终端登录。Agent 无法绕过认证，密码不会出现在对话历史中。
数据范围在登录时锁定到当前账户，存储在不可导出的 Go 结构体字段中。没有任何参数可以覆盖。
写操作默认关闭，需要显式添加 --enable-writes 参数。所有写工具描述以 WARNING: 开头。
110 个 MCP 工具
覆盖采购、销售、库存、财务、员工、BI 等全部业务模块
三步接入
安装 fwh
下载对应平台的二进制文件，或从源码编译
chmod +x fwh-darwin-arm64
mv fwh-darwin-arm64 /usr/local/bin/fwh登录账户
使用手机号登录，建立安全会话
fwh login --user 13800138000
# Password: ********
# logged in as 13800138000 (user_id=1)配置 AI Agent
将 MCP Server 配置添加到 Agent 设置中
# ~/.claude/mcp.json
{
"mcpServers": {
"flash-warehouse": {
"command": "/usr/local/bin/fwh",
"args": ["mcp", "--enable-writes"]
}
}
}下载
单个静态二进制，无运行时依赖，开箱即用
从源码编译: go build -o fwh ./cmd/fwh
实战场景
Agent 监控库存预警，自动生成采购建议单，经确认后创建采购订单并跟踪入库。
扫码或语音输入商品条码，Agent 自动查库存、创建出库单、审核，一气呵成。
自然语言查询销售趋势、库存周转率、应收应付，Agent 调用 BI 工具生成报表。
Agent 创建盘点任务，按仓库分配给员工，实时汇总差异，自动生成调整单。