item-wms-public-api-tool 2.0.7 → 2.0.8

package/AI_INTEGRATION_GUIDE.md

@@ -26,7 +26,7 @@ MCP (Model Control Plane) 通过以下机制实现与AI工具的集成：
 ```
 
 ```json
-{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"post_v1_public_user_login","arguments":{"username":"testuser","password":"testpass"},"options":{"baseUrl":"https://wms-staging.item.com/api/public"}}}
+{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"user_login","arguments":{"username":"testuser","password":"testpass"},"options":{"baseUrl":"https://wms-staging.item.com/api/public"}}}
 ```
 
 ### 1.3 Prompts（代码生成提示）
@@ -49,7 +49,7 @@ MCP (Model Control Plane) 通过以下机制实现与AI工具的集成：
 CLI/脚本 → 读取 openapi.yaml → 动态生成命令 → 直接调用 HTTP API
 ```
 
-说明：工具名称由 OpenAPI 自动生成（`<method>_<path>`），CLI 与 MCP 使用同一套工具名。可用 `list/describe` 查看工具详情。
+说明：工具名称由 OpenAPI 自动生成（`<path>`，先移除 `/v1/public/` 前缀），CLI 与 MCP 使用同一套工具名。可用 `list/describe` 查看工具详情；如有重名会追加请求方式后缀。
 
 ## 2. mcp.json文件分析
 
@@ -81,7 +81,7 @@ CLI/脚本 → 读取 openapi.yaml → 动态生成命令 → 直接调用 HTTP
 
 ```json
 {
-  "name": "post_v1_public_user_login",
+  "name": "user_login",
   "description": "User authentication and access token retrieval for system access",
   "inputSchema": {
     "type": "object",
@@ -122,12 +122,12 @@ AI工具根据用户需求选择合适的工具：
 // 根据功能描述匹配工具
 const loginTool = mcpConfig.tools.find(tool => 
   tool.description.includes('authentication') || 
-  tool.name === 'post_v1_public_user_login'
+  tool.name === 'user_login'
 );
 
 // 根据名称精确匹配
 const orderQueryTool = mcpConfig.tools.find(tool => 
-  tool.name === 'post_v1_public_edi_outbound_order_level_search_by_paging'
+  tool.name === 'edi_outbound_order_level_search_by_paging'
 );
 ```
 
@@ -149,8 +149,8 @@ console.log('必传参数:', requiredParams);
 AI工具根据工具名称和参数构造 MCP `tools/call` 请求：
 
 ```javascript
-// 工具名由 <method>_<path> 生成
-const toolName = 'post_v1_public_user_login';
+// 工具名由 <path> 生成（先移除 /v1/public/ 前缀）
+const toolName = 'user_login';
 
 const request = {
   jsonrpc: '2.0',
@@ -214,7 +214,7 @@ if (result.success) {
   
   // 使用token调用其他工具
   const orderResult = await executeMCPCommand(
-    `${mcpConfig.entrypoint} call post_v1_public_edi_outbound_order_level_search_by_paging --json '{"Paging":{"page":1,"pageSize":10}}' --token ${result.onAuthToken}`
+    `${mcpConfig.entrypoint} call edi_outbound_order_level_search_by_paging --json '{"Paging":{"page":1,"pageSize":10}}' --token ${result.onAuthToken}`
   );
   
   console.log('订单查询结果:', orderResult);
@@ -259,7 +259,7 @@ node test-ai-integration.js
    ✅ 工具数量: <N>
 
 2. 验证工具定义
-   1. post_v1_public_user_login
+   1. user_login
       描述: User authentication and access token retrieval for system access
       输入Schema: 有效
       必传参数: ["username","password"]
@@ -327,7 +327,7 @@ class MCPIntegration {
   // 登录方法
   async login(username, password, baseUrl) {
     this.baseUrl = baseUrl;
-    const result = await this.executeCommand('post_v1_public_user_login', {
+    const result = await this.executeCommand('user_login', {
       username,
       password
     });
@@ -342,7 +342,7 @@ class MCPIntegration {
 
   // 订单查询方法
   async queryOrders(params) {
-    return this.executeCommand('post_v1_public_edi_outbound_order_level_search_by_paging', params);
+    return this.executeCommand('edi_outbound_order_level_search_by_paging', params);
   }
 
   // 发现工具
@@ -398,7 +398,7 @@ const uploadTools = mcp.getAllTools().filter(tool =>
 console.log('文件上传相关工具:', uploadTools.map(tool => tool.name));
 
 // 精确查找工具
-const loginTool = mcp.findTool('post_v1_public_user_login');
+const loginTool = mcp.findTool('user_login');
 console.log('登录工具:', loginTool.name, '-', loginTool.description);
 ```
 
@@ -485,7 +485,7 @@ console.log('登录工具:', loginTool.name, '-', loginTool.description);
 本MCP设计符合AI工具集成的最佳实践，通过：
 
 1. **自描述配置**：完整的工具定义和参数说明
-2. **标准化接口**：统一的工具命名规则（`<method>_<path>`）
+2. **标准化接口**：统一的工具命名规则（`<path>`）
 3. **结构化输出**：JSON格式结果
 4. **清晰的文档**：详细的集成指南
 

package/HELP.md

@@ -39,7 +39,7 @@ item-wms-public-api-tool <toolName> [options]
 item-wms-public-api-tool call <toolName> [options]
 ```
 
-工具名称根据 OpenAPI 自动生成：`<method>_<path>`（非字母数字替换为 `_`），例如 `post_v1_public_user_login`。
+工具名称根据 OpenAPI 自动生成：`<path>`（先移除 `/v1/public/` 前缀，非字母数字替换为 `_`），例如 `user_login`；如有重名会追加请求方式后缀。
 
 ### 动态工具发现
 
@@ -52,13 +52,13 @@ item-wms-public-api-tool describe <toolName>
 
 ```bash
 # 单个字段（可重复）
-item-wms-public-api-tool post_v1_public_user_login --param username=test --param password=pass
+item-wms-public-api-tool user_login --param username=test --param password=pass
 
 # 直接传 JSON
-item-wms-public-api-tool post_v1_public_user_login --json '{"username":"test","password":"pass"}'
+item-wms-public-api-tool user_login --json '{"username":"test","password":"pass"}'
 
 # 从文件读取 JSON
-item-wms-public-api-tool post_v1_public_user_login --file ./payload.json
+item-wms-public-api-tool user_login --file ./payload.json
 ```
 
 ### 全局选项
@@ -96,7 +96,7 @@ export WMS_FACILITY_ID=889
 export WMS_CUSTOMER_ID=FLAANT0001
 
 # 现在可以直接执行命令，无需重复输入 baseUrl、token、CompanyID、FacilityID、CustomerID
-item-wms-public-api-tool post_v1_public_edi_outbound_order_level_search_by_paging \
+item-wms-public-api-tool edi_outbound_order_level_search_by_paging \
   --json '{"Paging":{"page":1,"pageSize":10}}'
 ```
 
@@ -113,13 +113,13 @@ item-wms-public-api-tool list
 ### 2. 用户登录
 
 ```bash
-item-wms-public-api-tool post_v1_public_user_login --param username=testuser --param password=testpass
+item-wms-public-api-tool user_login --param username=testuser --param password=testpass
 ```
 
 ### 3. 按订单维度查询订单
 
 ```bash
-item-wms-public-api-tool post_v1_public_edi_outbound_order_level_search_by_paging \
+item-wms-public-api-tool edi_outbound_order_level_search_by_paging \
   --json '{"CompanyID":"TEST_COM","CustomerID":"TEST_CUST","FacilityID":"TEST_FAC","Paging":{"page":1,"pageSize":10}}' \
   --token YOUR_TOKEN
 ```
@@ -127,7 +127,7 @@ item-wms-public-api-tool post_v1_public_edi_outbound_order_level_search_by_pagin
 ### 4. 批量导入物品主数据
 
 ```bash
-item-wms-public-api-tool post_v1_public_edi_item_master_import \
+item-wms-public-api-tool edi_item_master_import \
   --json '{"items":[{"itemID":"ITEM001","itemDescription":"测试物品","companyId":"TEST_COM","customerId":"TEST_CUST"}]}' \
   --token YOUR_TOKEN
 ```
@@ -147,7 +147,7 @@ npx item-wms-public-api-tool --help
 A: 通过登录接口获取：
 
 ```bash
-item-wms-public-api-tool post_v1_public_user_login --param username=YOUR_USERNAME --param password=YOUR_PASSWORD
+item-wms-public-api-tool user_login --param username=YOUR_USERNAME --param password=YOUR_PASSWORD
 ```
 
 提示：在 MCP stdio 模式下，登录返回 `onAuthToken` 后会自动缓存到进程内存，后续调用未显式传 `--token` 时会自动使用；CLI 每次命令仍需传 `--token` 或设置 `WMS_TOKEN`。
@@ -162,7 +162,7 @@ A: 可能的原因及解决方法：
 
 ```bash
 # 对于WMS认证
-item-wms-public-api-tool post_v1_public_user_login --param username=YOUR_USERNAME --param password=YOUR_PASSWORD
+item-wms-public-api-tool user_login --param username=YOUR_USERNAME --param password=YOUR_PASSWORD
 ```
 
 ### Q: 如何查看特定命令的帮助
@@ -170,8 +170,8 @@ item-wms-public-api-tool post_v1_public_user_login --param username=YOUR_USERNAM
 A: 使用 `describe` 查看接口详情，或使用 `--help` 查看命令用法：
 
 ```bash
-item-wms-public-api-tool describe post_v1_public_edi_outbound_order_level_search_by_paging
-item-wms-public-api-tool post_v1_public_edi_outbound_order_level_search_by_paging --help
+item-wms-public-api-tool describe edi_outbound_order_level_search_by_paging
+item-wms-public-api-tool edi_outbound_order_level_search_by_paging --help
 ```
 
 ### Q: 如何从文件读取JSON数据
@@ -180,10 +180,10 @@ A: 使用命令行参数直接传递JSON字符串，或通过脚本读取文件
 
 ```bash
 # 直接传递JSON
-item-wms-public-api-tool post_v1_public_edi_item_master_import --json '{"items":[{"itemID":"ITEM001","itemDescription":"测试物品"}]}' --token YOUR_TOKEN
+item-wms-public-api-tool edi_item_master_import --json '{"items":[{"itemID":"ITEM001","itemDescription":"测试物品"}]}' --token YOUR_TOKEN
 
 # 或使用文件
-item-wms-public-api-tool post_v1_public_edi_item_master_import --file items.json --token YOUR_TOKEN
+item-wms-public-api-tool edi_item_master_import --file items.json --token YOUR_TOKEN
 ```
 
 ## API 列表

package/README.md

@@ -54,8 +54,8 @@ npx item-wms-public-api-tool --help
 
 ```bash
 item-wms-public-api-tool list
-item-wms-public-api-tool describe post_v1_public_user_login
-item-wms-public-api-tool post_v1_public_user_login --param username=USERNAME --param password=PASSWORD
+item-wms-public-api-tool describe user_login
+item-wms-public-api-tool user_login --param username=USERNAME --param password=PASSWORD
 ```
 
 默认 baseUrl 为 `https://wms-staging.item.com/api/public`，也可以通过 `--baseUrl` 传入覆盖。
@@ -76,7 +76,7 @@ export WMS_CUSTOMER_ID=FLAANT0001
 # 当接口包含 CompanyID/FacilityID/CustomerID 且请求未显式传递时，会自动使用配置值（未配置时使用默认值）。
 
 # 现在可以直接执行命令，无需重复输入 baseUrl/token/CompanyID/FacilityID/CustomerID
-item-wms-public-api-tool post_v1_public_edi_outbound_order_level_search_by_paging \
+item-wms-public-api-tool edi_outbound_order_level_search_by_paging \
   --json '{"Paging":{"page":1,"pageSize":10}}'
 ```
 
@@ -93,10 +93,10 @@ item-wms-public-api-tool post_v1_public_edi_outbound_order_level_search_by_pagin
 ```
 
 ```json
-{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"post_v1_public_user_login","arguments":{"username":"USERNAME","password":"PASSWORD"},"options":{"baseUrl":"https://wms-staging.item.com/api/public"}}}
+{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"user_login","arguments":{"username":"USERNAME","password":"PASSWORD"},"options":{"baseUrl":"https://wms-staging.item.com/api/public"}}}
 ```
 
-工具名称根据 OpenAPI 自动生成：`<method>_<path>`（非字母数字替换为 `_`），例如 `post_v1_public_user_login`。完整列表请见 `mcp.json`。
+工具名称根据 OpenAPI 自动生成：`<path>`（先移除 `/v1/public/` 前缀，非字母数字替换为 `_`），例如 `user_login`；如有重名会追加请求方式后缀。完整列表请见 `mcp.json`。
 运行时工具列表同样支持 `APIFOX_PATH_PREFIX` 过滤（未设置时默认 `/v1/public/`）。
 同一 MCP 进程内，若登录返回 `onAuthToken`，服务会自动缓存并用于后续调用（未显式传 token 时）。