MCP 配置中心

Model Context Protocol

通过 AI 客户端直接管理仓库系统

MCP 服务运行中

🔐 生成 API Token(推荐)

点击下方按钮生成安全的 API Token,用于连接 AI 客户端

✅ Token 生成成功!

⚠️ 请妥善保管此 Token。关闭页面后如未保存,将无法再次查看完整 Token。 可在 API Token 管理 页面查看所有 Token。
🍒

Cherry Studio

AI 客户端配置

配置步骤

  • 打开 Cherry Studio 应用
  • 进入 设置 → MCP 服务器
  • 点击 添加服务器
  • 使用下方配置

配置内容(API Token 方式 - 推荐)

{
  "mcpServers": {
    "warehouse": {
      "type": "streamable-http",
      "url": "http://localhost:8001/mcp?token=YOUR_API_TOKEN"
    }
  }
}

配置内容(用户名密码方式)

{
  "mcpServers": {
    "warehouse": {
      "type": "streamable-http",
      "url": "http://localhost:8001/mcp?token=admin:admin123"
    }
  }
}

提示:将 localhost 替换为实际服务器地址(如果是远程部署)

🤖

Claude Desktop

桌面应用配置

配置文件位置

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

配置内容(API Token 方式 - 推荐)

{
  "mcpServers": {
    "warehouse": {
      "url": "http://localhost:8001/mcp?token=YOUR_API_TOKEN",
      "transport": "streamable-http"
    }
  }
}

配置内容(用户名密码方式)

{
  "mcpServers": {
    "warehouse": {
      "url": "http://localhost:8001/mcp?token=admin:admin123",
      "transport": "streamable-http"
    }
  }
}

提示:配置后需重启 Claude Desktop 才能生效

💻

Cline

VS Code 扩展配置

配置步骤

  • 打开 VS Code 设置
  • 搜索 cline.mcpServers
  • 添加下方配置

配置内容(API Token 方式 - 推荐)

{
  "cline.mcpServers": {
    "warehouse": {
      "url": "http://localhost:8001/mcp?token=YOUR_API_TOKEN",
      "transport": "streamable-http"
    }
  }
}

配置内容(用户名密码方式)

{
  "cline.mcpServers": {
    "warehouse": {
      "url": "http://localhost:8001/mcp?token=admin:admin123",
      "transport": "streamable-http"
    }
  }
}

提示:在 VS Code 的 settings.json 中添加此配置

🔐

认证说明

Token 格式

两种认证方式

推荐方式:使用 API Token(更安全)

?token=wmck_xxxxxxxxxxxxxxx

兼容方式:使用用户密码

?token=username:password

优势:API Token 可随时撤销,不暴露用户密码,可设置过期时间

🛠️ 可用 MCP 工具(共 28 个)

create_product

创建新产品(自动生成SKU和别名)

query_products

查询产品(SKU/别名/名称/类别/供应商)

update_product

更新产品信息(按SKU或别名定位)

delete_product

删除产品(按SKU或别名)

search_by_description

通过自然语言描述搜索产品

query_inventory

查询库存(按仓库和SKU筛选)

list_warehouses

列出所有仓库信息

update_warehouse

更新仓库信息(别名/负责人/电话等)

create_inbound

创建单个入库单

batch_inbound

批量创建入库单

update_inbound_date

修改入库单的入库日期

create_outbound

创建出库单(自动检查库存)

batch_outbound

批量创建出库单

update_outbound_date

修改出库单的出库日期

create_return

创建退货单

batch_return

批量创建退货单(支持每项独立状态)

query_returns

查询退货单列表

update_return_date

修改退货单的退货日期

query_defective_products

查询残次品列表

process_defective_product

处理残次品(列入入库单/销毁)

query_destruction_records

查询销毁记录列表

smart_batch_operation

智能批量操作(入库/出库/退货)

smart_query

智能查询(入库/出库/退货/残次品等)

execute_command

执行简短自然语言指令

get_sku_report

获取SKU完整数据报告

get_statistics

获取统计数据(出货/库存/货值/退货)

get_value_statistics

获取货值统计数据

get_dashboard

获取仪表盘数据(系统概览)