闪仓 MCP Server 正式上线：国内首个支持 Model Context Protocol 的仓储管理系统

一个新的里程碑

今天，闪仓 WMS 正式发布 MCP Server 功能。据我们所知，这是国内第一个完整支持 Model Context Protocol（模型上下文协议） 的仓库管理系统。

这意味着什么？从今天起，你可以让 AI Agent 直接读取和操作你的仓库数据——查库存、建采购单、审核单据、生成经营报表——全部通过自然语言完成，无需打开任何网页界面。

什么是 MCP

Model Context Protocol 是由 Anthropic 提出的开放协议，它定义了 AI 模型与外部工具之间的标准通信方式。简单来说，MCP 让 AI Agent 能够"使用工具"，就像人类使用软件一样。

闪仓的 MCP Server 通过命令行工具 fwh 实现。fwh 是一个用 Go 编写的跨平台静态二进制文件，零依赖，支持 macOS、Linux 和 Windows。它既是传统的命令行工具（23 个顶级命令），也是一个完整的 MCP Server（110 个工具）。

110 个工具，覆盖进销存全流程

MCP Server 提供的工具按业务领域组织，与 PC 端功能完全对齐：

商品管理：goods_list、goods_get、goods_search_barcode、goods_create、goods_modify、goods_delete
仓库管理：warehouse_list、warehouse_create、warehouse_modify、warehouse_delete
库存预警：alert_overview、alert_list、alert_set_config、alert_refresh
单据操作：覆盖全部 16 种单据类型的创建、审核、驳回、删除，以及 7 种单据转换（询价转订单、订单转入库等）
经营分析：bi_total_value、bi_line_chart、bi_today_sales_revenue 等 8 个 BI 工具
人员权限：合作伙伴、员工、角色、权限的完整 CRUD
收银 POS：pos_sell 支持扫码零售出库
盘点任务：创建、执行、完成盘点的全流程

其中 44 个为只读工具（查询类），默认始终可用；66 个为写入工具（创建、修改、删除、审核等），需要显式启用。

支持三大主流 AI Agent

闪仓 MCP Server 已验证支持以下 AI 编程工具：

Claude Code -- 在 ~/.claude/mcp.json 中配置：

{
  "mcpServers": {
    "flash-warehouse": {
      "command": "/path/to/fwh",
      "args": ["mcp"]
    }
  }
}

Cursor -- 在 ~/.cursor/mcp.json 中使用相同格式配置。

Windsurf -- 在 ~/.codeium/windsurf/mcp_config.json 中配置。

如需启用写入操作，将 args 改为 ["mcp", "--enable-writes"] 即可。

安全模型：四层防护

将 AI Agent 接入生产系统，安全是第一位的。闪仓 MCP Server 围绕四个硬性不变量设计：

登录先行（Login-first）：MCP Server 启动前必须先在终端执行 fwh login 完成认证。Agent 无法通过工具调用完成登录——这是刻意为之，避免对话历史中出现明文密码。

租户锁定（Tenant-locked）：binding_user_id 在登录时一次性设定，存储在 Go 的未导出结构体字段中，没有 setter、没有 CLI 参数、没有环境变量可以覆盖它。源码级审计测试 TestTenantLock_UserIDChokepoints 在每次构建时验证这一不变量。

写入需授权（Writes opt-in）：未传 --enable-writes 时，写入工具根本不会注册到 MCP Server 的工具清单中——Agent 无法调用一个不存在的工具。每个写入工具的描述都以 WARNING: 开头，确保模型在推理阶段就能识别操作的破坏性。

会话吊销（Session revocation）：如果在 MCP Server 运行期间执行了 fwh logout，Server 会在下一次工具调用时检测到会话文件消失，并返回 session_revoked 错误。

三步上手

第一步：构建 fwh

cd flash_warehouse_cli
go build -o ./bin/fwh ./cmd/fwh
ln -sf $(pwd)/bin/fwh ~/.local/bin/fwh

第二步：登录

fwh login --user 你的手机号
# 按提示输入密码
fwh whoami  # 确认身份

第三步：配置 Agent

以 Claude Code 为例，编辑 ~/.claude/mcp.json：

{
  "mcpServers": {
    "flash-warehouse": {
      "command": "/absolute/path/to/fwh",
      "args": ["mcp", "--enable-writes"]
    }
  }
}

配置完成后，在 Claude Code 中直接对话即可操作仓库。例如：

"帮我查一下仓库里可口可乐的库存"
"创建一张采购入库单，供应商是王老板，入库 500 箱矿泉水到主仓"
"本月的进出库趋势图数据是什么"
"审核通过单号 PO-20260601-001"

下一步计划

当前 fwh 处于 v0.2 版本，已实现与 PC 端的完整功能对齐。接下来我们将发布：

GoReleaser 自动化发布流水线，支持 brew install 和 scoop install 一键安装
AI 工具的 SSE 流式响应支持
更多 Agent 平台的适配验证

闪仓始终免费开放。如果你是中小企业仓库管理者，同时也在使用 AI 编程工具，现在就可以体验用自然语言管理仓库的全新方式。

访问 flashwarehouse.cn 了解更多，或直接从源码构建 fwh 开始使用。