yindie-erp-mcp 1.0.0

package/dist/auth.js

@@ -0,0 +1,80 @@
+import { createCipheriv, createDecipheriv, createPrivateKey, createPublicKey, privateDecrypt, publicEncrypt, randomBytes } from 'node:crypto';
+/** 默认 RSA 公钥（与 yindie-web 开发环境一致） */
+const DEFAULT_RSA_PUBLIC_KEY = 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDvEDuRIOM3oZPWj9Ukoc5pQklR4PFH6/clnjeFqjDLIgDyQvjxhgqAZQA+E9eD6qu6FsXPmK8djcL+nh3cFHz4pX473jDvO3Sve+8yL3VRQ0n2pRgQ2a01MJsy+WwTZCBYWf0VnLRIvANUoWQgy9vz94q7Va44dg7A1/3ICf+xAwIDAQAB';
+/** 默认 RSA 私钥（解密登录响应） */
+const DEFAULT_RSA_PRIVATE_KEY = 'MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBAObq7yrxfvyieZtTjAYyrdvi59tYTXxjO5ajmPCRSXBY9M9wQ1tli297JN6mnY53UJMNyOFNSZVi8WSFoIXjpR87FmvChJlzeN/dZdd3SEs48Ee66XKeSePYqxa8oO5GKDsnajgpsOHKXSeeVSIysiIPS2/WsEqk0In9P4w3RsRFAgMBAAECgYBiMEWwce24SPICnRzuScBpvmsudrbEDIH7BOd0a6LZlcnLJwZNJ7mJlshPsHNQb+WgEf135+BBGEhioPtn0yuTdEuKP4kB9UdYUKiayWCoWhJpesv7sAD4RDClV7dhuV+gcd1AXD+YzyRIPbGm0VC2U+4q8/+UPRpVjqskbLVTgQJBAPRpou7g3S8n4XB527kq0D8I3+ZYwMxZhszwhrCDpJU319+ucmpLVwYIzDmZVeID2QQdUaDfIEViFHu95xDrGiUCQQDx3YOKn3yaEctk/ERVn7hDAyAXUbd8/pv2b24/M/l1ZevlsFem8U4Jk5Mu64t3z3YGJoymEjQmbucwT01iKhehAkEAxlnccsRmfFh/KkqauKE4M4++NTAd9zlInpUsmZ+cN8UEGnF2RTEzRKBrLOt1uWCqBB7PGiE6DVTVjr7FAQPrSQJAT5yeY87DcONSk9cFlzmPqV8p/QME5rvYEnHzVBKDlkUKNPyqnWToTvaoh9U4fyNmsfeWbEOprszqhFhWHG3GgQJAK8+ynmyFhaw63+Hx2KU5zR4hVuQso2IzrEurGxCxybV6mR7VBerb4502+EPx3PmOgxQL+niUFhcMWxcvBFP9+A==';
+/** 生成 32 字节 AES 密钥 */
+function generateAesKey() {
+    return Buffer.from(randomBytes(16).toString('hex').slice(0, 32), 'utf8');
+}
+/** PEM 包装 */
+function toPublicPem(key) {
+    return `-----BEGIN PUBLIC KEY-----\n${key}\n-----END PUBLIC KEY-----`;
+}
+/** PEM 包装 */
+function toPrivatePem(key) {
+    return `-----BEGIN PRIVATE KEY-----\n${key}\n-----END PRIVATE KEY-----`;
+}
+/** AES/ECB 加密 */
+function encryptWithAes(message, aesKey) {
+    const cipher = createCipheriv('aes-256-ecb', aesKey, null);
+    return Buffer.concat([cipher.update(message, 'utf8'), cipher.final()]).toString('base64');
+}
+/** AES/ECB 解密 */
+function decryptWithAes(message, aesKey) {
+    const decipher = createDecipheriv('aes-256-ecb', aesKey, null);
+    return Buffer.concat([decipher.update(message, 'base64'), decipher.final()]).toString('utf8');
+}
+/** RSA 公钥加密 */
+function rsaEncrypt(text, publicKey) {
+    const key = createPublicKey(toPublicPem(publicKey));
+    return publicEncrypt({ key, padding: 1 }, Buffer.from(text, 'utf8')).toString('base64');
+}
+/** RSA 私钥解密 */
+function rsaDecrypt(cipherText, privateKey) {
+    const key = createPrivateKey(toPrivatePem(privateKey));
+    return privateDecrypt({ key, padding: 1 }, Buffer.from(cipherText, 'base64')).toString('utf8');
+}
+/** 解析可能被加密的 JSON 响应 */
+function parseResponse(raw, headers, rsaPrivateKey) {
+    const encryptKey = headers.get('encrypt-key');
+    if (encryptKey) {
+        const aesKey = Buffer.from(rsaDecrypt(encryptKey, rsaPrivateKey), 'base64');
+        return JSON.parse(decryptWithAes(raw, aesKey));
+    }
+    return JSON.parse(raw);
+}
+/** 账号密码登录并返回 access_token */
+export async function login(params) {
+    const aesKey = generateAesKey();
+    const body = JSON.stringify({
+        clientId: params.clientId,
+        grantType: 'password',
+        username: params.username,
+        password: params.password
+    });
+    const response = await fetch(new URL('/auth/login', params.baseUrl), {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'encrypt-key': rsaEncrypt(Buffer.from(aesKey).toString('base64'), params.rsaPublicKey)
+        },
+        body: encryptWithAes(body, aesKey)
+    });
+    const result = parseResponse(await response.text(), response.headers, params.rsaPrivateKey);
+    if (result.code !== 200) {
+        throw new Error(result.msg || '登录失败');
+    }
+    if (!result.data?.access_token) {
+        throw new Error('登录失败：未返回 access_token');
+    }
+    return result.data.access_token;
+}
+/** 默认 RSA 公钥 */
+export function defaultRsaPublicKey() {
+    return DEFAULT_RSA_PUBLIC_KEY;
+}
+/** 默认 RSA 私钥 */
+export function defaultRsaPrivateKey() {
+    return DEFAULT_RSA_PRIVATE_KEY;
+}

package/dist/client.js

@@ -0,0 +1,75 @@
+/** ERP API 客户端 */
+export class YindieClient {
+    /** 后端根地址 */
+    baseUrl;
+    /** 访问令牌 */
+    token;
+    /** 客户端 ID */
+    clientId;
+    /** token 过期时重新登录 */
+    relogin;
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.token = config.token;
+        this.clientId = config.clientId;
+        this.relogin = config.relogin;
+    }
+    /** 拉取当前用户菜单权限 */
+    async loadPermissions() {
+        const info = await this.get('/system/user/getInfo');
+        return info.permissions ?? [];
+    }
+    /** GET 请求 */
+    async get(path, params) {
+        return (await this.request('GET', path, undefined, params));
+    }
+    /** POST 请求 */
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    /** PUT 请求 */
+    async put(path, body) {
+        return this.request('PUT', path, body);
+    }
+    /** DELETE 请求 */
+    async delete(path) {
+        return this.request('DELETE', path);
+    }
+    /** 统一 HTTP 请求 */
+    async request(method, path, body, params, retried = false) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== '') {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            clientid: this.clientId
+        };
+        const init = { method, headers };
+        if (body !== undefined && method !== 'GET') {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, init);
+        const result = (await response.json());
+        if (result.code === 401 && !retried) {
+            this.token = await this.relogin();
+            return this.request(method, path, body, params, true);
+        }
+        if (result.code !== 200) {
+            throw new Error(result.msg || `请求失败: ${path}`);
+        }
+        if (method === 'GET') {
+            return result.data;
+        }
+        return {
+            success: true,
+            msg: result.msg || '操作成功',
+            data: result.data
+        };
+    }
+}

package/dist/config.js

@@ -0,0 +1,30 @@
+import { defaultRsaPrivateKey, defaultRsaPublicKey, login } from './auth.js';
+/** 从环境变量读取配置并自动登录 */
+export async function loadConfig() {
+    const baseUrl = process.env.YINDIE_BASE_URL;
+    const username = process.env.YINDIE_USERNAME;
+    const password = process.env.YINDIE_PASSWORD;
+    const clientId = 'e5cd7e4891bf95d1d19206ce24a7b32e';
+    if (!baseUrl) {
+        throw new Error('缺少环境变量 YINDIE_BASE_URL');
+    }
+    if (!username || !password) {
+        throw new Error('缺少环境变量 YINDIE_USERNAME 或 YINDIE_PASSWORD');
+    }
+    const normalizedBaseUrl = baseUrl.replace(/\/$/, '');
+    const loginParams = {
+        baseUrl: normalizedBaseUrl,
+        username,
+        password,
+        clientId,
+        rsaPublicKey: process.env.YINDIE_RSA_PUBLIC_KEY ?? defaultRsaPublicKey(),
+        rsaPrivateKey: process.env.YINDIE_RSA_PRIVATE_KEY ?? defaultRsaPrivateKey()
+    };
+    const accessToken = await login(loginParams);
+    return {
+        baseUrl: normalizedBaseUrl,
+        token: accessToken,
+        clientId,
+        relogin: () => login(loginParams)
+    };
+}

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { YindieClient } from './client.js';
+import { loadConfig } from './config.js';
+import { ERP_BUSINESS_FLOW } from './tool-meta.js';
+import { filterTools } from './tools.js';
+/** 启动 ERP MCP 服务 */
+async function main() {
+    const config = await loadConfig();
+    const client = new YindieClient(config);
+    const permissions = await client.loadPermissions();
+    const tools = filterTools(permissions);
+    const server = new McpServer({
+        name: 'yindie-erp',
+        version: '1.0.0'
+    });
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema
+        }, async (args) => {
+            const data = await tool.handler(client, args ?? {});
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }]
+            };
+        });
+    }
+    server.registerResource('erp_business_flow', 'yindie://erp/business-flow', {
+        description: 'ERP 主业务流程、订单/生产单状态机、枚举值与业务约束，操作前建议先读',
+        mimeType: 'application/json'
+    }, async () => ({
+        contents: [
+            {
+                uri: 'yindie://erp/business-flow',
+                mimeType: 'application/json',
+                text: JSON.stringify(ERP_BUSINESS_FLOW, null, 2)
+            }
+        ]
+    }));
+    server.registerResource('erp_modules', 'yindie://erp/modules', {
+        description: '当前账号可见的 ERP MCP 工具列表及权限',
+        mimeType: 'application/json'
+    }, async () => ({
+        contents: [
+            {
+                uri: 'yindie://erp/modules',
+                mimeType: 'application/json',
+                text: JSON.stringify({
+                    toolCount: tools.length,
+                    tools: tools.map((item) => ({
+                        name: item.name,
+                        description: item.description,
+                        permission: item.permission
+                    }))
+                }, null, 2)
+            }
+        ]
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('[yindie-erp-mcp]', error instanceof Error ? error.message : error);
+    process.exit(1);
+});

package/dist/tool-helpers.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+/** JSON 请求体字段 */
+export const payloadField = z.string().describe('JSON 请求体，字段与后端 BO 一致');
+/** 主键字段 */
+export const idsField = z.string().describe('主键 ID，多个用英文逗号分隔');
+/** 单个主键字段，字符串避免雪花 ID 精度丢失 */
+export const idField = z.string().describe('主键 ID');
+/** 解析 JSON 请求体 */
+export function parsePayload(args) {
+    const raw = args.payload;
+    if (typeof raw === 'string') {
+        return JSON.parse(raw);
+    }
+    if (raw && typeof raw === 'object') {
+        return raw;
+    }
+    throw new Error('payload 必须是 JSON 字符串');
+}
+/** 解析删除主键 */
+export function parseIds(args) {
+    if (typeof args.ids === 'string') {
+        return args.ids;
+    }
+    if (typeof args.id === 'number' || typeof args.id === 'string') {
+        return String(args.id);
+    }
+    throw new Error('缺少 ids 或 id');
+}

package/dist/tool-meta.js

@@ -0,0 +1,428 @@
+import { z } from 'zod';
+/** 拼接工具描述 */
+function joinParts(parts) {
+    return parts.filter(Boolean).join(' ');
+}
+/** 生成 CRUD 工具描述 */
+export function buildCrudDescription(action, meta) {
+    const verb = action === 'add' ? '新增' : action === 'edit' ? '修改' : '删除';
+    if (action === 'remove') {
+        return joinParts([
+            `【${meta.module}】${verb}${meta.label}。`,
+            meta.prerequisite ? `【前置】${meta.prerequisite}` : undefined,
+            meta.removeConstraint ? `【约束】${meta.removeConstraint}` : undefined
+        ]);
+    }
+    const fields = action === 'add' ? meta.addRequired : meta.editRequired ?? meta.addRequired;
+    const optional = action === 'add' ? meta.addOptional : undefined;
+    return joinParts([
+        `【${meta.module}】${verb}${meta.label}，${meta.step}。`,
+        meta.prerequisite ? `【前置】${meta.prerequisite}` : undefined,
+        `【必填】${fields}。`,
+        optional ? `【可选】${optional}。` : undefined,
+        meta.enums ? `【枚举】${meta.enums}` : undefined,
+        meta.next ? `【后续】${meta.next}` : undefined
+    ]);
+}
+/** 生成 payload 字段描述 */
+export function payloadFor(meta, action) {
+    const fields = action === 'add' ? meta.addRequired : meta.editRequired ?? meta.addRequired;
+    const optional = action === 'add' ? meta.addOptional : undefined;
+    const enumPart = meta.enums ? ` ${meta.enums}` : '';
+    const optionalPart = optional ? ` 可选:${optional}` : '';
+    return z
+        .string()
+        .describe(`JSON 对象。必填:${fields}${optionalPart}.${enumPart}`);
+}
+/** 生成流程工具描述 */
+export function buildWorkflowDescription(meta) {
+    return joinParts([
+        `【${meta.module}】${meta.summary}，${meta.step}。`,
+        `【前置】${meta.prerequisite}`,
+        `【入参】${meta.payload}`,
+        meta.enums ? `【枚举】${meta.enums}` : undefined,
+        meta.constraint ? `【约束】${meta.constraint}` : undefined,
+        meta.returns ? `【返回】${meta.returns}` : undefined,
+        meta.next ? `【后续】${meta.next}` : undefined
+    ]);
+}
+/** 生成查询工具描述 */
+export function buildReadDescription(base, meta) {
+    if (!meta) {
+        return base;
+    }
+    return joinParts([base, meta.usage, meta.returns ? `返回:${meta.returns}` : undefined]);
+}
+/** 实体元数据表 */
+export const ENTITY_META = {
+    erp_customer: {
+        module: '客户管理',
+        step: '业务流程第1步：建档',
+        label: '客户',
+        addRequired: 'customerCode, customerName, customerType',
+        addOptional: 'country, defaultCurrency, communicationChannel, email, phone, assigneeId, status, remark',
+        editRequired: 'id, customerCode, customerName, customerType',
+        enums: 'customerType:direct/trader/foreign_trade; status:active/inactive(默认active)',
+        removeConstraint: '客户存在关联PI时不可删除',
+        next: 'erp_customer_contact_add → erp_customer_address_add → erp_pi_add'
+    },
+    erp_customer_contact: {
+        module: '客户管理',
+        step: '客户建档后补充联系人',
+        label: '客户联系人',
+        prerequisite: '客户已创建',
+        addRequired: 'customerId, contactName',
+        addOptional: 'position, email, phone, whatsapp, isPrimary(Y/N), remark',
+        editRequired: 'id, customerId, contactName'
+    },
+    erp_customer_address: {
+        module: '客户管理',
+        step: '客户建档后补充地址',
+        label: '客户地址',
+        prerequisite: '客户已创建',
+        addRequired: 'customerId, addressType, detailAddress',
+        addOptional: 'recipient, company, country, province, city, postalCode, phone, isDefault(Y/N), remark',
+        editRequired: 'id, customerId, addressType, detailAddress',
+        enums: 'addressType:shipping/billing/sample'
+    },
+    erp_customer_brand: {
+        module: '客户管理',
+        step: '客户建档后维护品牌',
+        label: '客户品牌',
+        prerequisite: '客户已创建',
+        addRequired: 'customerId, brandName',
+        addOptional: 'brandCode, status, remark',
+        editRequired: 'id, customerId, brandName'
+    },
+    erp_pi: {
+        module: 'PI管理',
+        step: '业务流程第2步：形式发票',
+        label: 'PI',
+        prerequisite: '客户已创建',
+        addRequired: 'customerId, piNo, sourceType',
+        addOptional: 'orderId, piVersion, paymentTerms, totalAmount, currency, qtyTolerance, shippingMethod, shippingAddress, piFileOssId, status, confirmedDate, remark',
+        editRequired: 'id, customerId, piNo, sourceType',
+        enums: 'sourceType:customer/internal; status:draft/confirmed/superseded(默认draft)',
+        next: 'erp_order_add → erp_order_link_pi'
+    },
+    erp_order: {
+        module: '订单管理',
+        step: '业务流程第3步：创建订单',
+        label: '订单',
+        prerequisite: '客户已创建',
+        addRequired: 'orderNo, customerId, bizLine, assigneeId',
+        addOptional: 'brandId, orderStatus(默认inquiry), orderDate, deliveryDate, contractDate, depositReceived(Y/N), qtyTolerance, shippingMethod, packingType, priority, sourceChannel, parentOrderId, remark',
+        editRequired: 'id, orderNo, customerId, bizLine, assigneeId',
+        enums: 'bizLine:direct/trader; orderStatus见erp_business_flow资源',
+        next: 'erp_order_link_pi → erp_order_style_save → erp_order_change_status'
+    },
+    erp_task: {
+        module: '任务协同',
+        step: '订单跟进过程中创建待办',
+        label: '跟进任务',
+        addRequired: 'taskType, taskTitle, assigneeId',
+        addOptional: 'orderId, taskContent, priority, dueDate, remindDate, taskStatus, source, relatedId, relatedType, remark',
+        editRequired: 'id, taskType, taskTitle, assigneeId',
+        enums: 'taskType:accessory_follow/bulk_sample/pre_prod_feedback/fabric_arrival/customer_follow/address_verify/custom; taskStatus:pending/in_progress/completed/cancelled; priority:low/normal/high/urgent'
+    },
+    erp_material: {
+        module: '主数据',
+        step: '维护面料/辅料等物料档案',
+        label: '物料',
+        addRequired: 'categoryId, materialCode, materialName',
+        addOptional: 'spec, color, unit, defaultSupplierId, supplierMaterialCode, composition, width, weight, status, remark',
+        editRequired: 'id, categoryId, materialCode, materialName'
+    },
+    erp_supplier: {
+        module: '主数据',
+        step: '维护供应商档案',
+        label: '供应商',
+        addRequired: 'supplierCode, supplierName',
+        addOptional: 'supplierType, contactName, phone, wechat, address, leadTimeDays, status, remark',
+        editRequired: 'id, supplierCode, supplierName',
+        enums: 'supplierType:fabric/accessory/both'
+    },
+    erp_email_account: {
+        module: '邮件',
+        step: '配置收发邮件账号',
+        label: '邮箱账号',
+        addRequired: 'accountName, emailAddress, imapHost, imapPort, authType, credential',
+        addOptional: 'smtpHost, smtpPort, ownerId, syncEnabled(Y/N), status',
+        editRequired: 'id, accountName, emailAddress, imapHost, imapPort, authType, credential'
+    },
+    erp_production: {
+        module: '生产管理',
+        step: '手动新建生产单(通常用fromOrder)',
+        label: '生产单',
+        prerequisite: '订单已存在',
+        addRequired: 'orderId, poNo, bizLine',
+        addOptional: 'poVersion, poStatus(默认draft), deliveryDate, qtyTolerance, shippingMethod, shippingAddress, packingType, bulkSampleRequired(Y/N), remark',
+        editRequired: 'id, orderId, poNo, bizLine',
+        enums: 'poStatus:draft/reviewing/issued/superseded',
+        removeConstraint: '已下发(issued)不可删除；仅draft可修改',
+        next: 'erp_production_save_items → erp_production_check → erp_production_submit_review → erp_production_issue'
+    }
+};
+/** 流程工具元数据表 */
+export const WORKFLOW_META = {
+    erp_order_change_status: {
+        module: '订单管理',
+        step: '推进订单生命周期',
+        summary: '变更订单状态',
+        prerequisite: '订单已创建',
+        payload: '{id, orderStatus, remark?}',
+        constraint: '流转: inquiry→sampling|doc_preparing; sampling→sample_confirmed; sample_confirmed→quoted; quoted→po_drafting; doc_preparing→pre_prod_sample; pre_prod_sample→pre_prod_confirmed; pre_prod_confirmed→po_drafting; po_drafting→po_ai_checking; po_ai_checking→po_reviewing|po_drafting; po_reviewing→po_issued',
+        next: 'po_drafting后 erp_production_create_from_order'
+    },
+    erp_order_assign: {
+        module: '订单管理',
+        step: '订单分派跟单员',
+        summary: '分派或变更跟单员',
+        prerequisite: '订单已创建',
+        payload: '{id, assigneeId}',
+        next: 'erp_order_style_save'
+    },
+    erp_order_link_pi: {
+        module: '订单管理',
+        step: '订单关联PI',
+        summary: '将PI绑定到订单',
+        prerequisite: '订单和PI均已创建',
+        payload: '{orderId, piIds: number[]}',
+        next: 'erp_order_style_save'
+    },
+    erp_order_style_save: {
+        module: '订单管理',
+        step: '录入款式明细',
+        summary: '保存订单款式及颜色尺码',
+        prerequisite: '订单已创建',
+        payload: '{orderId, styles:[{styleNo, styleName?, colors:[{colorName, sizes:[{sizeName, qty}]}]}]}',
+        next: 'erp_order_style_craft_save'
+    },
+    erp_order_style_craft_save: {
+        module: '订单管理',
+        step: '录入结构化工艺',
+        summary: '保存款式上衣/裤子工艺及商标位置',
+        prerequisite: '款式已保存且有 styleId',
+        payload: '{styleId, crafts:[{garmentPart, craftModule, fieldKey, fieldValue}], labelPositions:[{garmentPart, labelType, positionSide?, sizeCm?, positionDesc?}]}',
+        enums: 'garmentPart:jacket/pants; fieldKey见 erp_order_craft_schema',
+        next: 'erp_order_change_status 或 erp_production_create_from_order'
+    },
+    erp_production_craft_save: {
+        module: '生产管理',
+        step: '填写结构化工艺',
+        summary: '生产单草稿阶段保存款式工艺',
+        prerequisite: '生产单 poStatus=draft，款式已存在',
+        payload: '同 erp_order_style_craft_save',
+        next: 'erp_production_check'
+    },
+    erp_order_attachment_add: {
+        module: '订单管理',
+        step: '上传订单附件',
+        summary: '新增订单附件',
+        prerequisite: '订单已创建，文件已上传OSS',
+        payload: '{orderId, attachType, fileName, ossId, fileSize?, source?, remark?}',
+        enums: 'attachType:pi/tech_drawing/customer_file/other'
+    },
+    erp_order_attachment_remove: {
+        module: '订单管理',
+        step: '删除订单附件',
+        summary: '删除订单附件',
+        prerequisite: '附件已存在',
+        payload: 'ids: 附件ID，多个逗号分隔'
+    },
+    erp_production_create_from_order: {
+        module: '生产管理',
+        step: '从订单生成生产单草稿',
+        summary: '一键创建生产单',
+        prerequisite: '订单已存在且尚无生产单',
+        payload: 'orderId: 订单ID',
+        constraint: '自动将订单状态改为po_drafting；生产单号=订单号-PO；每单仅一条',
+        next: 'erp_production_save_items → erp_production_check'
+    },
+    erp_production_save_items: {
+        module: '生产管理',
+        step: '填写生产单明细',
+        summary: '保存生产单物料/工艺明细',
+        prerequisite: '生产单处于draft',
+        payload: '{productionOrderId, items:[{itemCategory, itemName, materialId?, spec?, color?, qty?, supplierId?, isRequired?}]}',
+        enums: 'itemCategory:button/label/hangtag/zipper/thread/process/other',
+        next: 'erp_production_check'
+    },
+    erp_production_check: {
+        module: '生产管理',
+        step: '人工校验缺项',
+        summary: '执行生产单完整性校验',
+        prerequisite: '生产单已存在',
+        payload: 'id: 生产单ID',
+        returns: '校验分数、缺项列表(checkResult: pass/warning/fail)',
+        next: 'erp_production_submit_review'
+    },
+    erp_production_submit_review: {
+        module: '生产管理',
+        step: '提交审核',
+        summary: '生产单提交审核',
+        prerequisite: '生产单poStatus=draft',
+        payload: 'id: 生产单ID',
+        constraint: '提交后poStatus→reviewing',
+        next: 'erp_production_issue 或 erp_production_reject_review'
+    },
+    erp_production_reject_review: {
+        module: '生产管理',
+        step: '审核退回',
+        summary: '生产单审核退回草稿',
+        prerequisite: '生产单poStatus=reviewing，需erp:production:review权限',
+        payload: 'id: 生产单ID',
+        constraint: '退回后poStatus→draft',
+        next: 'erp_production_save_items'
+    },
+    erp_production_issue: {
+        module: '生产管理',
+        step: '下发工厂',
+        summary: '生产单正式下发',
+        prerequisite: '生产单poStatus=reviewing，需erp:production:issue权限',
+        payload: 'id: 生产单ID',
+        constraint: '下发后poStatus→issued，关联订单状态→po_issued',
+        next: '流程结束'
+    },
+    erp_email_thread_link: {
+        module: '邮件',
+        step: '邮件关联业务单据',
+        summary: '邮件线程关联订单或客户',
+        prerequisite: '邮件线程已同步',
+        payload: '{id, orderId?, customerId?}',
+        next: 'erp_order_timeline_list 查看跟进'
+    }
+};
+/** 查询工具补充说明 */
+export const READ_META = {
+    erp_workbench_summary: {
+        usage: '【入口】建议首先调用，获取待办任务、超期任务、缺项生产单、近期订单概览'
+    },
+    erp_customer_list: {
+        usage: '筛选客户类型 direct/trader/foreign_trade，状态 active/inactive'
+    },
+    erp_customer_get: {
+        usage: '查客户主档详情',
+        returns: '客户基本信息'
+    },
+    erp_customer_contact_list: { usage: '查某客户下全部联系人' },
+    erp_customer_address_list: { usage: '查某客户地址，可按 shipping/billing/sample 筛选' },
+    erp_customer_brand_list: { usage: '查某客户品牌列表，建订单时 brandId 来源' },
+    erp_pi_list: { usage: 'PI状态 draft/confirmed/superseded，可按 customerId 筛选' },
+    erp_pi_get: { usage: '查PI详情含金额、运输、发货地址' },
+    erp_order_list: {
+        usage: '订单状态见 erp_business_flow；可按 orderStatus/assigneeId/customerId 筛选'
+    },
+    erp_order_get: { usage: '查订单主档', returns: '订单基本信息' },
+    erp_order_style_list: { usage: '查订单款式→颜色→尺码→工艺→商标位置，制单前必查' },
+    erp_order_craft_schema: { usage: '查工艺字段定义及受控字典类型，填工艺前建议先读' },
+    erp_production_craft_schema: { usage: '查生产单工艺字段定义，同订单 schema' },
+    erp_order_timeline_list: { usage: '查订单状态变更、生产事件等跟进时间线' },
+    erp_order_attachment_list: { usage: '查订单附件列表' },
+    erp_production_list: { usage: '生产单状态 draft/reviewing/issued/superseded' },
+    erp_production_get: { usage: '查生产单主档及缺项信息' },
+    erp_production_check_list: { usage: '查生产单历次校验记录及得分' },
+    erp_task_list: { usage: '任务状态 pending/in_progress/completed/cancelled' },
+    erp_task_get: { usage: '查任务详情' },
+    erp_material_category_list: { usage: '查物料分类树，新建物料前先查 categoryId' },
+    erp_material_list: { usage: '分页查物料，可按分类/编码/名称筛选' },
+    erp_material_get: { usage: '查物料详情' },
+    erp_supplier_list: { usage: '供应商类型 fabric/accessory/both' },
+    erp_supplier_get: { usage: '查供应商详情' },
+    erp_email_account_list: { usage: '查已配置邮箱账号' },
+    erp_email_account_get: { usage: '查邮箱账号详情' },
+    erp_email_thread_list: { usage: '查邮件线程，可按 orderId 筛选已关联邮件' },
+    erp_email_thread_get: { usage: '查邮件线程详情含正文', returns: '邮件正文及关联信息' }
+};
+/** ERP 业务流程文档 */
+export const ERP_BUSINESS_FLOW = {
+    overview: '外贸服装ERP：客户建档 → PI形式发票 → 订单(款式/附件/跟单) → 生产单(校验/审核/下发)。物料/供应商为主数据，邮件/任务为协同手段。',
+    mainFlow: [
+        '1. erp_customer_add 建客户',
+        '2. erp_customer_contact_add / erp_customer_address_add / erp_customer_brand_add 补全资料',
+        '3. erp_pi_add 创建PI(需customerId, piNo, sourceType)',
+        '4. erp_order_add 创建订单(需orderNo, customerId, bizLine, assigneeId，默认inquiry)',
+        '5. erp_order_link_pi 关联PI',
+        '6. erp_order_style_save 录入款式颜色尺码',
+        '7. erp_order_change_status 按规则推进状态',
+        '8. erp_order_style_craft_save 录入上衣/裤子结构化工艺',
+        '9. erp_production_create_from_order 生成生产单草稿',
+        '9. erp_production_save_items 填写明细',
+        '10. erp_production_check 人工校验',
+        '11. erp_production_submit_review 提交审核',
+        '12. erp_production_issue 下发(订单→po_issued)'
+    ],
+    orderStatus: {
+        default: 'inquiry',
+        transitions: {
+            inquiry: ['sampling', 'doc_preparing'],
+            sampling: ['sample_confirmed'],
+            sample_confirmed: ['quoted'],
+            quoted: ['po_drafting'],
+            doc_preparing: ['pre_prod_sample'],
+            pre_prod_sample: ['pre_prod_confirmed'],
+            pre_prod_confirmed: ['po_drafting'],
+            po_drafting: ['po_ai_checking'],
+            po_ai_checking: ['po_reviewing', 'po_drafting'],
+            po_reviewing: ['po_issued'],
+            po_issued: []
+        },
+        labels: {
+            inquiry: '询盘沟通',
+            sampling: '打样中',
+            sample_confirmed: '样衣确认',
+            quoted: '报价签约',
+            doc_preparing: '资料整理',
+            pre_prod_sample: '产前样',
+            pre_prod_confirmed: '产前样确认',
+            po_drafting: '制单中',
+            po_ai_checking: 'AI校验',
+            po_reviewing: '人工审核',
+            po_issued: '已下发'
+        }
+    },
+    productionStatus: {
+        default: 'draft',
+        transitions: {
+            draft: ['reviewing'],
+            reviewing: ['issued', 'draft'],
+            issued: [],
+            superseded: []
+        },
+        labels: {
+            draft: '草稿',
+            reviewing: '待审核',
+            issued: '已下发',
+            superseded: '已作废'
+        }
+    },
+    enums: {
+        customerType: { direct: '自营', trader: '贸易商', foreign_trade: '外贸公司' },
+        customerStatus: { active: '正常', inactive: '停用' },
+        piSourceType: { customer: '客户提供', internal: '我方生成' },
+        piStatus: { draft: '草稿', confirmed: '已确认', superseded: '已作废' },
+        bizLine: { direct: '自营', trader: '贸易商' },
+        addressType: { shipping: '收货地址', billing: '账单地址', sample: '样衣寄送' },
+        attachType: { pi: 'PI文件', tech_drawing: '工艺图', customer_file: '客户文件', other: '其他' },
+        poItemCategory: {
+            button: '纽扣',
+            label: '商标',
+            hangtag: '吊牌',
+            zipper: '拉链',
+            thread: '线',
+            process: '工艺',
+            other: '其他'
+        }
+    },
+    constraints: [
+        '客户存在关联PI时不可删除',
+        '每订单仅一条生产单(erp_production_create_from_order)',
+        '生产单仅draft可修改/编辑明细',
+        '生产单submit_review: draft→reviewing',
+        '生产单reject_review: reviewing→draft(需review权限)',
+        '生产单issue: reviewing→issued(需issue权限)，同步订单→po_issued',
+        '已下发(issued)生产单不可删除'
+    ],
+    entryPoint: 'erp_workbench_summary',
+    resourceHint: '操作前先读 yindie://erp/business-flow 和 yindie://erp/modules'
+};

package/dist/tools-write.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { idField, idsField, parseIds, parsePayload } from './tool-helpers.js';
+import { buildCrudDescription, buildWorkflowDescription, ENTITY_META, payloadFor, WORKFLOW_META } from './tool-meta.js';
+/** 生成标准 CRUD 写工具 */
+function entityCrud(name, basePath, perm) {
+    const meta = ENTITY_META[name];
+    return [
+        {
+            name: `${name}_add`,
+            description: buildCrudDescription('add', meta),
+            permission: `${perm}:add`,
+            inputSchema: { payload: payloadFor(meta, 'add') },
+            handler: (client, args) => client.post(basePath, parsePayload(args))
+        },
+        {
+            name: `${name}_edit`,
+            description: buildCrudDescription('edit', meta),
+            permission: `${perm}:edit`,
+            inputSchema: { payload: payloadFor(meta, 'edit') },
+            handler: (client, args) => client.put(basePath, parsePayload(args))
+        },
+        {
+            name: `${name}_remove`,
+            description: buildCrudDescription('remove', meta),
+            permission: `${perm}:remove`,
+            inputSchema: { ids: idsField },
+            handler: (client, args) => client.delete(`${basePath}/${parseIds(args)}`)
+        }
+    ];
+}
+/** 生成流程写工具 */
+function workflowTool(name, permission, inputSchema, handler) {
+    return {
+        name,
+        description: buildWorkflowDescription(WORKFLOW_META[name]),
+        permission,
+        inputSchema,
+        handler
+    };
+}
+/** ERP 写操作工具 */
+export const WRITE_TOOLS = [
+    ...entityCrud('erp_customer', '/erp/customer', 'erp:customer'),
+    ...entityCrud('erp_customer_contact', '/erp/customer/contact', 'erp:customer'),
+    ...entityCrud('erp_customer_address', '/erp/customer/address', 'erp:customer'),
+    ...entityCrud('erp_customer_brand', '/erp/customer/brand', 'erp:customer'),
+    ...entityCrud('erp_pi', '/erp/pi', 'erp:pi'),
+    ...entityCrud('erp_order', '/erp/order', 'erp:order'),
+    ...entityCrud('erp_task', '/erp/task', 'erp:task'),
+    ...entityCrud('erp_material', '/erp/material', 'erp:material'),
+    ...entityCrud('erp_supplier', '/erp/supplier', 'erp:supplier'),
+    ...entityCrud('erp_email_account', '/erp/email/account', 'erp:email:account'),
+    ...entityCrud('erp_production', '/erp/production', 'erp:production'),
+    workflowTool('erp_order_change_status', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_change_status.payload) }, (client, args) => client.put('/erp/order/status', parsePayload(args))),
+    workflowTool('erp_order_assign', 'erp:order:assign', { payload: z.string().describe(WORKFLOW_META.erp_order_assign.payload) }, (client, args) => client.put('/erp/order/assign', parsePayload(args))),
+    workflowTool('erp_order_link_pi', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_link_pi.payload) }, (client, args) => client.put('/erp/order/pi/link', parsePayload(args))),
+    workflowTool('erp_order_style_save', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_style_save.payload) }, (client, args) => client.post('/erp/order/style/save', parsePayload(args))),
+    workflowTool('erp_order_style_craft_save', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_style_craft_save.payload) }, (client, args) => client.post('/erp/order/style/craft/save', parsePayload(args))),
+    workflowTool('erp_production_craft_save', 'erp:production:edit', { payload: z.string().describe(WORKFLOW_META.erp_production_craft_save.payload) }, (client, args) => client.post('/erp/production/craft/save', parsePayload(args))),
+    workflowTool('erp_order_attachment_add', 'erp:order:edit', { payload: z.string().describe(WORKFLOW_META.erp_order_attachment_add.payload) }, (client, args) => client.post('/erp/order/attachment', parsePayload(args))),
+    workflowTool('erp_order_attachment_remove', 'erp:order:remove', { ids: idsField }, (client, args) => client.delete(`/erp/order/attachment/${parseIds(args)}`)),
+    workflowTool('erp_production_create_from_order', 'erp:production:add', { orderId: idField.describe('订单 ID，每单仅可生成一条生产单') }, (client, args) => client.post(`/erp/production/fromOrder/${args.orderId}`)),
+    workflowTool('erp_production_save_items', 'erp:production:edit', { payload: z.string().describe(WORKFLOW_META.erp_production_save_items.payload) }, (client, args) => client.post('/erp/production/item/save', parsePayload(args))),
+    workflowTool('erp_production_check', 'erp:production:edit', { id: idField.describe('生产单 ID') }, (client, args) => client.post(`/erp/production/check/${args.id}`)),
+    workflowTool('erp_production_submit_review', 'erp:production:edit', { id: idField.describe('生产单 ID，需 poStatus=draft') }, (client, args) => client.put(`/erp/production/review/submit/${args.id}`)),
+    workflowTool('erp_production_reject_review', 'erp:production:review', { id: idField.describe('生产单 ID，需 poStatus=reviewing') }, (client, args) => client.put(`/erp/production/review/reject/${args.id}`)),
+    workflowTool('erp_production_issue', 'erp:production:issue', { id: idField.describe('生产单 ID，需 poStatus=reviewing') }, (client, args) => client.put(`/erp/production/issue/${args.id}`)),
+    workflowTool('erp_email_thread_link', 'erp:email:thread:link', { payload: z.string().describe(WORKFLOW_META.erp_email_thread_link.payload) }, (client, args) => client.put('/erp/email/thread/link', parsePayload(args)))
+];

package/dist/tools.js

@@ -0,0 +1,381 @@
+import { z } from 'zod';
+import { buildReadDescription, READ_META } from './tool-meta.js';
+import { WRITE_TOOLS } from './tools-write.js';
+/** 分页入参 */
+const pageShape = {
+    pageNum: z.number().optional().describe('页码，默认 1'),
+    pageSize: z.number().optional().describe('每页条数，默认 20，最大 100')
+};
+/** 解析分页参数 */
+function pageParams(args) {
+    const pageNum = args.pageNum == null ? 1 : Number(args.pageNum);
+    const pageSize = args.pageSize == null ? 20 : Math.min(Number(args.pageSize), 100);
+    return { pageNum, pageSize };
+}
+/** 判断用户是否拥有权限 */
+export function hasPermission(permissions, required) {
+    if (required == null) {
+        return true;
+    }
+    if (permissions.includes('*:*:*')) {
+        return true;
+    }
+    return permissions.includes(required);
+}
+/** ERP 查询工具 */
+const READ_TOOLS = [
+    {
+        name: 'erp_workbench_summary',
+        description: '查询 ERP 工作台摘要（待办、超期任务、缺项生产单、近期订单）',
+        permission: null,
+        inputSchema: {},
+        handler: (client) => client.get('/erp/workbench/summary')
+    },
+    {
+        name: 'erp_customer_list',
+        description: '分页查询客户列表，可按客户编码、名称、类型、状态筛选',
+        permission: 'erp:customer:list',
+        inputSchema: {
+            ...pageShape,
+            customerCode: z.string().optional().describe('客户编码'),
+            customerName: z.string().optional().describe('客户名称'),
+            customerType: z.string().optional().describe('客户类型'),
+            status: z.string().optional().describe('状态')
+        },
+        handler: (client, args) => client.get('/erp/customer/list', {
+            ...pageParams(args),
+            customerCode: args.customerCode,
+            customerName: args.customerName,
+            customerType: args.customerType,
+            status: args.status
+        })
+    },
+    {
+        name: 'erp_customer_get',
+        description: '按 ID 查询客户详情',
+        permission: 'erp:customer:query',
+        inputSchema: {
+            id: z.number().describe('客户 ID')
+        },
+        handler: (client, args) => client.get(`/erp/customer/${args.id}`)
+    },
+    {
+        name: 'erp_customer_contact_list',
+        description: '查询客户联系人列表',
+        permission: 'erp:customer:list',
+        inputSchema: {
+            customerId: z.number().describe('客户 ID'),
+            contactName: z.string().optional().describe('联系人姓名')
+        },
+        handler: (client, args) => client.get('/erp/customer/contact/list', {
+            customerId: args.customerId,
+            contactName: args.contactName
+        })
+    },
+    {
+        name: 'erp_customer_address_list',
+        description: '查询客户地址列表',
+        permission: 'erp:customer:list',
+        inputSchema: {
+            customerId: z.number().describe('客户 ID'),
+            addressType: z.string().optional().describe('地址类型 shipping/billing/sample')
+        },
+        handler: (client, args) => client.get('/erp/customer/address/list', {
+            customerId: args.customerId,
+            addressType: args.addressType
+        })
+    },
+    {
+        name: 'erp_customer_brand_list',
+        description: '查询客户品牌列表',
+        permission: 'erp:customer:list',
+        inputSchema: {
+            customerId: z.number().describe('客户 ID'),
+            brandName: z.string().optional().describe('品牌名称'),
+            status: z.string().optional().describe('状态')
+        },
+        handler: (client, args) => client.get('/erp/customer/brand/list', {
+            customerId: args.customerId,
+            brandName: args.brandName,
+            status: args.status
+        })
+    },
+    {
+        name: 'erp_pi_list',
+        description: '分页查询 PI（形式发票）列表',
+        permission: 'erp:pi:list',
+        inputSchema: {
+            ...pageShape,
+            piNo: z.string().optional().describe('PI 编号'),
+            customerId: z.number().optional().describe('客户 ID'),
+            status: z.string().optional().describe('状态')
+        },
+        handler: (client, args) => client.get('/erp/pi/list', {
+            ...pageParams(args),
+            piNo: args.piNo,
+            customerId: args.customerId,
+            status: args.status
+        })
+    },
+    {
+        name: 'erp_pi_get',
+        description: '按 ID 查询 PI 详情',
+        permission: 'erp:pi:query',
+        inputSchema: {
+            id: z.number().describe('PI ID')
+        },
+        handler: (client, args) => client.get(`/erp/pi/${args.id}`)
+    },
+    {
+        name: 'erp_order_list',
+        description: '分页查询订单列表',
+        permission: 'erp:order:list',
+        inputSchema: {
+            ...pageShape,
+            orderNo: z.string().optional().describe('订单号'),
+            customerId: z.number().optional().describe('客户 ID'),
+            orderStatus: z.string().optional().describe('订单状态'),
+            assigneeId: z.number().optional().describe('跟单员 ID')
+        },
+        handler: (client, args) => client.get('/erp/order/list', {
+            ...pageParams(args),
+            orderNo: args.orderNo,
+            customerId: args.customerId,
+            orderStatus: args.orderStatus,
+            assigneeId: args.assigneeId
+        })
+    },
+    {
+        name: 'erp_order_get',
+        description: '按 ID 查询订单详情',
+        permission: 'erp:order:query',
+        inputSchema: {
+            id: z.number().describe('订单 ID')
+        },
+        handler: (client, args) => client.get(`/erp/order/${args.id}`)
+    },
+    {
+        name: 'erp_order_style_list',
+        description: '查询订单款式及颜色尺码、结构化工艺、商标位置明细',
+        permission: 'erp:order:query',
+        inputSchema: {
+            orderId: z.number().describe('订单 ID')
+        },
+        handler: (client, args) => client.get('/erp/order/style/list', { orderId: args.orderId })
+    },
+    {
+        name: 'erp_order_craft_schema',
+        description: '查询工艺字段定义（上衣/裤子受控选项 schema）',
+        permission: 'erp:order:query',
+        inputSchema: {},
+        handler: (client) => client.get('/erp/order/style/craft/schema')
+    },
+    {
+        name: 'erp_production_craft_schema',
+        description: '查询生产单工艺字段定义',
+        permission: 'erp:production:query',
+        inputSchema: {},
+        handler: (client) => client.get('/erp/production/craft/schema')
+    },
+    {
+        name: 'erp_order_timeline_list',
+        description: '查询订单跟进时间线',
+        permission: 'erp:order:query',
+        inputSchema: {
+            orderId: z.number().describe('订单 ID')
+        },
+        handler: (client, args) => client.get('/erp/order/timeline/list', { orderId: args.orderId })
+    },
+    {
+        name: 'erp_order_attachment_list',
+        description: '查询订单附件列表',
+        permission: 'erp:order:query',
+        inputSchema: {
+            orderId: z.number().describe('订单 ID')
+        },
+        handler: (client, args) => client.get('/erp/order/attachment/list', { orderId: args.orderId })
+    },
+    {
+        name: 'erp_production_list',
+        description: '分页查询生产单列表',
+        permission: 'erp:production:list',
+        inputSchema: {
+            ...pageShape,
+            productionNo: z.string().optional().describe('生产单号'),
+            orderId: z.number().optional().describe('订单 ID'),
+            status: z.string().optional().describe('状态')
+        },
+        handler: (client, args) => client.get('/erp/production/list', {
+            ...pageParams(args),
+            productionNo: args.productionNo,
+            orderId: args.orderId,
+            status: args.status
+        })
+    },
+    {
+        name: 'erp_production_get',
+        description: '按 ID 查询生产单详情',
+        permission: 'erp:production:query',
+        inputSchema: {
+            id: z.number().describe('生产单 ID')
+        },
+        handler: (client, args) => client.get(`/erp/production/${args.id}`)
+    },
+    {
+        name: 'erp_production_check_list',
+        description: '查询生产单校验记录',
+        permission: 'erp:production:query',
+        inputSchema: {
+            productionOrderId: z.number().describe('生产单 ID')
+        },
+        handler: (client, args) => client.get('/erp/production/check/list', {
+            productionOrderId: args.productionOrderId
+        })
+    },
+    {
+        name: 'erp_task_list',
+        description: '分页查询跟进任务列表',
+        permission: 'erp:task:list',
+        inputSchema: {
+            ...pageShape,
+            taskTitle: z.string().optional().describe('任务标题'),
+            taskStatus: z.string().optional().describe('任务状态'),
+            assigneeId: z.number().optional().describe('负责人 ID')
+        },
+        handler: (client, args) => client.get('/erp/task/list', {
+            ...pageParams(args),
+            taskTitle: args.taskTitle,
+            taskStatus: args.taskStatus,
+            assigneeId: args.assigneeId
+        })
+    },
+    {
+        name: 'erp_task_get',
+        description: '按 ID 查询跟进任务详情',
+        permission: 'erp:task:query',
+        inputSchema: {
+            id: z.number().describe('任务 ID')
+        },
+        handler: (client, args) => client.get(`/erp/task/${args.id}`)
+    },
+    {
+        name: 'erp_material_category_list',
+        description: '查询物料分类树',
+        permission: 'erp:material:list',
+        inputSchema: {},
+        handler: (client) => client.get('/erp/material/category/list')
+    },
+    {
+        name: 'erp_material_list',
+        description: '分页查询物料列表',
+        permission: 'erp:material:list',
+        inputSchema: {
+            ...pageShape,
+            materialCode: z.string().optional().describe('物料编码'),
+            materialName: z.string().optional().describe('物料名称'),
+            categoryId: z.number().optional().describe('分类 ID')
+        },
+        handler: (client, args) => client.get('/erp/material/list', {
+            ...pageParams(args),
+            materialCode: args.materialCode,
+            materialName: args.materialName,
+            categoryId: args.categoryId
+        })
+    },
+    {
+        name: 'erp_material_get',
+        description: '按 ID 查询物料详情',
+        permission: 'erp:material:query',
+        inputSchema: {
+            id: z.number().describe('物料 ID')
+        },
+        handler: (client, args) => client.get(`/erp/material/${args.id}`)
+    },
+    {
+        name: 'erp_supplier_list',
+        description: '分页查询供应商列表',
+        permission: 'erp:supplier:list',
+        inputSchema: {
+            ...pageShape,
+            supplierCode: z.string().optional().describe('供应商编码'),
+            supplierName: z.string().optional().describe('供应商名称'),
+            status: z.string().optional().describe('状态')
+        },
+        handler: (client, args) => client.get('/erp/supplier/list', {
+            ...pageParams(args),
+            supplierCode: args.supplierCode,
+            supplierName: args.supplierName,
+            status: args.status
+        })
+    },
+    {
+        name: 'erp_supplier_get',
+        description: '按 ID 查询供应商详情',
+        permission: 'erp:supplier:query',
+        inputSchema: {
+            id: z.number().describe('供应商 ID')
+        },
+        handler: (client, args) => client.get(`/erp/supplier/${args.id}`)
+    },
+    {
+        name: 'erp_email_account_list',
+        description: '分页查询邮箱账号列表',
+        permission: 'erp:email:account:list',
+        inputSchema: {
+            ...pageShape,
+            accountName: z.string().optional().describe('账号名称'),
+            emailAddress: z.string().optional().describe('邮箱地址')
+        },
+        handler: (client, args) => client.get('/erp/email/account/list', {
+            ...pageParams(args),
+            accountName: args.accountName,
+            emailAddress: args.emailAddress
+        })
+    },
+    {
+        name: 'erp_email_account_get',
+        description: '按 ID 查询邮箱账号详情',
+        permission: 'erp:email:account:query',
+        inputSchema: {
+            id: z.number().describe('邮箱账号 ID')
+        },
+        handler: (client, args) => client.get(`/erp/email/account/${args.id}`)
+    },
+    {
+        name: 'erp_email_thread_list',
+        description: '分页查询邮件线程列表',
+        permission: 'erp:email:thread:list',
+        inputSchema: {
+            ...pageShape,
+            subject: z.string().optional().describe('邮件主题'),
+            orderId: z.number().optional().describe('关联订单 ID')
+        },
+        handler: (client, args) => client.get('/erp/email/thread/list', {
+            ...pageParams(args),
+            subject: args.subject,
+            orderId: args.orderId
+        })
+    },
+    {
+        name: 'erp_email_thread_get',
+        description: '按 ID 查询邮件线程详情（含邮件正文）',
+        permission: 'erp:email:thread:query',
+        inputSchema: {
+            id: z.number().describe('邮件线程 ID')
+        },
+        handler: (client, args) => client.get(`/erp/email/thread/${args.id}`)
+    }
+];
+/** 补充查询工具描述 */
+function enrichReadTools(tools) {
+    return tools.map((tool) => ({
+        ...tool,
+        description: buildReadDescription(tool.description, READ_META[tool.name])
+    }));
+}
+/** ERP 全部工具 */
+export const ERP_TOOLS = [...enrichReadTools(READ_TOOLS), ...WRITE_TOOLS];
+/** 按权限过滤可用工具 */
+export function filterTools(permissions) {
+    return ERP_TOOLS.filter((tool) => hasPermission(permissions, tool.permission));
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "yindie-erp-mcp",
+  "version": "1.0.0",
+  "description": "印蝶 ERP 独立 MCP 服务，通过 RuoYi API 提供只读查询能力",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "yindie-erp-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "release": "npm publish --registry=https://registry.npmjs.org --access public",
+    "login": "npm login --registry=https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3"
+  }
+}