@wukongcrm/mcp-server 0.2.1 → 0.2.3

package/README.md

@@ -147,7 +147,7 @@ npm pack
 生成文件示例：
 
 ```text
-wukongcrm-mcp-server-0.2.0.tgz
+wukongcrm-mcp-server-0.2.3.tgz
 ```
 
 这个包只包含运行所需的 `dist`、`README.md` 和 `package.json`，不会携带源码、测试文件或用户 API Key。
@@ -155,7 +155,7 @@ wukongcrm-mcp-server-0.2.0.tgz
 使用者拿到 `.tgz` 后安装：
 
 ```powershell
-npm install -g .\wukongcrm-mcp-server-0.2.0.tgz
+npm install -g .\wukongcrm-mcp-server-0.2.3.tgz
 ```
 
 安装后可以直接用命令启动：

package/dist/client.d.ts

@@ -19,6 +19,7 @@ export declare class CrmClient {
     private readonly apiKey;
     private readonly fetchImpl;
     private adminToken;
+    private loginPromise;
     constructor(config?: CrmClientConfig);
     authStatus(): Promise<AuthStatusResult>;
     call<T = unknown>(method: "GET" | "POST", path: string, body?: unknown, query?: Record<string, unknown>): Promise<T>;

package/dist/client.js

@@ -5,6 +5,7 @@ export class CrmClient {
     apiKey;
     fetchImpl;
     adminToken = "";
+    loginPromise;
     constructor(config = {}) {
         this.baseUrl = normalizeBaseUrl(config.baseUrl ?? process.env.CRM_BASE_URL ?? "https://www.72crm.com/api-11/");
         this.apiKey = config.apiKey ?? process.env.CRM_API_KEY ?? "";
@@ -51,7 +52,14 @@ export class CrmClient {
         if (!force && this.adminToken.trim()) {
             return;
         }
-        this.adminToken = await this.loginWithApiKey();
+        // Schema 聚合会并发请求多个只读接口。首次调用时必须把 API Key 登录合并成一次，
+        // 否则旧 CRM 会在短时间内收到多次登录并让部分请求鉴权失败。
+        if (!this.loginPromise) {
+            this.loginPromise = this.loginWithApiKey().finally(() => {
+                this.loginPromise = undefined;
+            });
+        }
+        this.adminToken = await this.loginPromise;
     }
     async loginWithApiKey() {
         try {

package/dist/nocode.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { type CrmClientConfig } from "./client.js";
+import { CrmClient, type CrmClientConfig } from "./client.js";
 export type NocodeToolAccess = "read" | "write";
 export interface NocodeToolDefinition {
     name: string;
@@ -12,5 +12,5 @@ type AnyArgs = Record<string, any>;
 type Handler = (args: AnyArgs) => Promise<any> | any;
 export type NocodeToolHandlers = Record<string, Handler>;
 export declare const nocodeToolDefinitions: NocodeToolDefinition[];
-export declare function createNocodeToolHandlers(config?: CrmClientConfig): NocodeToolHandlers;
+export declare function createNocodeToolHandlers(config?: CrmClientConfig, sharedClient?: CrmClient): NocodeToolHandlers;
 export {};

package/dist/nocode.js

@@ -1,6 +1,9 @@
 import { z } from "zod";
 import { CrmClient } from "./client.js";
-const idSchema = z.union([z.string(), z.number()]);
+const idSchema = z.union([
+    z.string().regex(/^\d+$/, "ID 必须是数字字符串。"),
+    z.number().int().safe("超过 JavaScript 安全整数范围的 ID 必须以字符串传入。")
+]);
 const payloadSchema = z.record(z.unknown());
 const confirmSchema = z.boolean().optional();
 const versionSchema = z.number().int().nonnegative().optional();
@@ -62,7 +65,7 @@ export const nocodeToolDefinitions = [
     },
     {
         name: "nocode_get_module_schema",
-        description: "一次获取无代码模块字段、表单布局、列表头、页面布局、选项、公式、标签和序列号规则；写入记录前应先调用，并优先使用 nocode_get_module 返回的实际 version（新建模块通常为 0）；只读。",
+        description: "一次获取无代码模块字段、表单布局、列表头、页面布局、选项、公式、标签和序列号规则；写入记录前应先调用，并优先使用 nocode_get_module 返回的实际 version（新建模块通常为 0）；雪花 moduleId 必须以字符串传入，避免 JavaScript 数字精度丢失；只读。",
         schema: z.object({ ...moduleContextShape, includeExtended: z.boolean().optional() }),
         access: "read"
     },
@@ -193,7 +196,7 @@ export const nocodeToolDefinitions = [
     },
     {
         name: "nocode_query_printing",
-        description: "查询无代码打印模板字段、模板列表/详情和打印记录；只读。打印、预览和模板变更请使用 nocode_write_printing。",
+        description: "查询无代码打印模板字段、模板列表/详情和打印记录；只读。records 会先确认当前模块存在打印模板，规避旧后端在空模板集合上生成无效 SQL；打印、预览和模板变更请使用 nocode_write_printing。",
         schema: z.object({
             operation: z.enum(["fields", "templates", "template", "records", "record"]),
             ...extendedContextShape
@@ -395,8 +398,8 @@ export const nocodeToolDefinitions = [
         destructive: true
     }
 ];
-export function createNocodeToolHandlers(config = {}) {
-    const client = new CrmClient(config);
+export function createNocodeToolHandlers(config = {}, sharedClient) {
+    const client = sharedClient ?? new CrmClient(config);
     return {
         nocode_list_applications: async () => readonlyResult("/moduleMetadata/customAppList", await client.post("/moduleMetadata/customAppList")),
         nocode_get_application: async (args) => {
@@ -432,10 +435,22 @@ export function createNocodeToolHandlers(config = {}) {
             const query = cleanObject({ moduleId: numericValue(moduleId), version, categoryId: args.categoryId });
             // 旧后端会直接拆箱 filterHidden；显式传 false 与无代码前端的字段配置请求保持一致，避免空值触发 500。
             const formQuery = { ...query, filterHidden: false };
-            const [fields, form, listHead, layout, unionModules] = await Promise.all([
+            const [fields, form, listHeadOutcome, layout, unionModules] = await Promise.all([
                 client.post("/moduleField/queryList", query),
                 client.post("/moduleField/formList", formQuery),
-                client.post("/moduleField/queryListHead", query),
+                client.post("/moduleField/queryListHead", query)
+                    .then((data) => ({ data, warning: undefined }))
+                    .catch((error) => {
+                    // 旧端的列表头服务只读取“已发布激活”的模块。新建草稿在字段已经存在时仍会返回 4303，
+                    // 但字段列表和表单结构本身可正常读取；不要让该可预期边界拖垮整个聚合 Schema。
+                    if (isModuleNotFoundError(error)) {
+                        return {
+                            data: [],
+                            warning: "当前模块尚未发布，旧 CRM 不提供列表头；fields/form 仍是有效的草稿 Schema。"
+                        };
+                    }
+                    throw error;
+                }),
                 client.post(`/moduleM/pageLayout/${moduleId}/${version}`),
                 client.post(`/moduleM/unionModules/${moduleId}/${version}`)
             ]);
@@ -453,9 +468,10 @@ export function createNocodeToolHandlers(config = {}) {
                 version,
                 fields,
                 form,
-                listHead,
+                listHead: listHeadOutcome.data,
                 layout,
                 unionModules,
+                ...(listHeadOutcome.warning ? { warnings: [listHeadOutcome.warning] } : {}),
                 ...extended
             };
         },
@@ -513,7 +529,7 @@ export function createNocodeToolHandlers(config = {}) {
         nocode_query_workflow: async (args) => executeNocodeRead(client, queryWorkflowRoute(args)),
         nocode_query_followups: async (args) => executeNocodeRead(client, queryFollowUpRoute(args)),
         nocode_query_configuration: async (args) => executeNocodeRead(client, queryConfigurationRoute(args)),
-        nocode_query_printing: async (args) => executeNocodeRead(client, queryPrintingRoute(args)),
+        nocode_query_printing: async (args) => executePrintingRead(client, args),
         nocode_query_messages: async (args) => executeNocodeRead(client, queryMessageRoute(args)),
         nocode_query_integrations: async (args) => executeNocodeRead(client, queryIntegrationRoute(args)),
         nocode_query_marketplace: async (args) => executeNocodeRead(client, queryMarketplaceRoute(args)),
@@ -566,6 +582,41 @@ export function createNocodeToolHandlers(config = {}) {
 async function executeNocodeRead(client, route) {
     return readonlyResult(route.targetPath, await client.post(route.targetPath, route.body, route.query), cleanObject({ operation: route.operation, body: route.body, query: route.query }));
 }
+async function executePrintingRead(client, args) {
+    const route = queryPrintingRoute(args);
+    if (route.operation !== "records") {
+        return executeNocodeRead(client, route);
+    }
+    const moduleId = requiredId(args.moduleId, "moduleId");
+    let version;
+    if (args.version !== undefined) {
+        version = requiredVersion(args.version);
+    }
+    else {
+        const moduleDetail = await client.post(`/moduleM/queryById/${moduleId}`, undefined, { isLatest: true });
+        version = requiredVersion(moduleDetail?.version);
+    }
+    // 旧后端 queryPrintRecord 会对空模板 ID 集合直接拼接 IN ()，最终只返回笼统的
+    // “Network Busy”。先用模板列表判断空集，空时按真实业务语义返回无打印记录。
+    const templatePath = `/modulePrintTemplate/list/${moduleId}/${version}`;
+    const templatePage = await client.post(templatePath, { page: 1, limit: 1 });
+    const templateRows = listRows(templatePage);
+    if (templateRows?.length === 0) {
+        return readonlyResult(route.targetPath, [], {
+            operation: route.operation,
+            preflight: { targetPath: templatePath, version, emptyTemplates: true }
+        });
+    }
+    return executeNocodeRead(client, route);
+}
+function listRows(value) {
+    if (Array.isArray(value))
+        return value;
+    if (!value || typeof value !== "object")
+        return undefined;
+    const list = value.list;
+    return Array.isArray(list) ? list : undefined;
+}
 function executeNocodeWrite(client, args, route) {
     return confirmedPost(client, args, route.operation, route.targetPath, route.body, route.query);
 }
@@ -1042,12 +1093,18 @@ function readonlyResult(targetPath, data, extra = {}) {
     return { readonly: true, targetPath, ...extra, data };
 }
 function requiredId(value, field) {
+    if (typeof value === "number" && !Number.isSafeInteger(value)) {
+        throw new Error(`${field} 超过 JavaScript 安全整数范围，必须以字符串传入。`);
+    }
     const normalized = String(value ?? "").trim();
     if (!/^\d+$/.test(normalized)) {
         throw new Error(`${field} 必须是数字 ID。`);
     }
     return normalized;
 }
+function isModuleNotFoundError(error) {
+    return error instanceof Error && error.message.includes("模块未找到");
+}
 function numericValue(value) {
     const numeric = Number(value);
     return Number.isSafeInteger(numeric) ? numeric : value;

package/dist/server.js

@@ -1,5 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
+import { CrmClient } from "./client.js";
 import { createNocodeToolHandlers, nocodeToolDefinitions } from "./nocode.js";
 import { createToolHandlers } from "./tools.js";
 export const CRM_READ_SCOPE = "crm.read";
@@ -20,6 +21,16 @@ const searchFilterSchema = z.object({
     values: z.array(z.unknown()).optional(),
     groupId: z.number().optional()
 }).passthrough();
+const crmCreateRecordSchema = z.object({
+    module: moduleSchema,
+    entity: z.record(z.unknown()).optional().describe("CRM 实体字段；系统字段放在这里，例如 entity.customerName。"),
+    field: z.array(z.record(z.unknown())).optional().describe("CRM 自定义字段列表。"),
+    saveType: z.number().optional(),
+    fileId: idSchema.optional(),
+    aiAnalysis: z.number().optional(),
+    member: z.record(z.unknown()).optional(),
+    confirm: z.boolean().optional()
+}).strict();
 const crmUserSearchShape = {
     ownerUserId: idSchema.optional(),
     ownerUserIds: z.array(idSchema).optional(),
@@ -137,7 +148,7 @@ const toolDefinitions = [
     ["crm_list_oa_tasks", "查询 OA 任务列表；固定调用 /oaTask/queryTaskList。", z.object({ page: z.number().optional(), limit: z.number().optional(), type: z.number().optional(), status: z.number().optional(), priority: z.number().optional() }).passthrough()],
     ["crm_list_related_oa_tasks", "按关联业务查询 OA 任务；固定调用 /oaTask/queryTypeTaskList。", z.object({ type: z.union([z.string(), z.number()]), typeId: z.union([z.string(), z.number()]) }).passthrough()],
     ["crm_preview_write", "写入前预览和校验，不调用 72CRM 写接口。", passthroughSchema],
-    ["crm_create_record", "新增线索、客户、联系人、产品、商机；必须 confirm=true 才会写入。", z.object({ module: moduleSchema, confirm: z.boolean().optional() }).passthrough()],
+    ["crm_create_record", "新增线索、客户、联系人、产品、商机；系统字段放 entity，自定义字段放 field，不支持把 customerName 放在最外层；必须 confirm=true 才会写入。", crmCreateRecordSchema],
     ["crm_update_customer", "按客户 ID 或手机号/客户名唯一匹配后更新客户字段；会自动补全字段结构并写后校验，必须 confirm=true 才会写入。", z.object({ confirm: z.boolean().optional() }).passthrough()],
     ["crm_update_record_fields", "更新线索、客户、联系人、产品、商机基础字段；必须 confirm=true 才会写入。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]), confirm: z.boolean().optional() }).passthrough()],
     ["crm_create_product", "新增 CRM 产品；固定调用 /crmProduct/add，可直接传 72CRM payload 或 entity/field，必须 confirm=true。", z.object({ confirm: z.boolean().optional() }).passthrough()],
@@ -181,13 +192,14 @@ export function createWukongMcpServer(config = {}) {
     const { oauth, ...crmConfig } = config;
     const server = new McpServer({
         name: "wukong-mcp",
-        version: "0.2.0"
+        version: "0.2.3"
     }, {
         instructions: "先使用只读工具确认模块、记录和字段，再执行写入。所有写入必须显式传 confirm=true；不要尝试任意 URL 请求。"
     });
+    const sharedClient = new CrmClient(crmConfig);
     const handlers = {
-        ...createToolHandlers(crmConfig),
-        ...createNocodeToolHandlers(crmConfig)
+        ...createToolHandlers(crmConfig, sharedClient),
+        ...createNocodeToolHandlers(crmConfig, sharedClient)
     };
     const registeredTools = [
         ...toolDefinitions.map(([name, description, schema]) => ({

package/dist/tools.d.ts

@@ -1,8 +1,8 @@
-import { CrmClientConfig } from "./client.js";
+import { CrmClient, CrmClientConfig } from "./client.js";
 type AnyArgs = Record<string, any>;
 type Handler = (args: AnyArgs) => Promise<any> | any;
 export interface ToolHandlers {
     [name: string]: Handler;
 }
-export declare function createToolHandlers(config?: CrmClientConfig): ToolHandlers;
+export declare function createToolHandlers(config?: CrmClientConfig, sharedClient?: CrmClient): ToolHandlers;
 export {};

package/dist/tools.js

@@ -332,8 +332,8 @@ const WRITE_DOMAINS = {
         allowedPrefixes: ["/finance"]
     }
 };
-export function createToolHandlers(config = {}) {
-    const client = new CrmClient(config);
+export function createToolHandlers(config = {}, sharedClient) {
+    const client = sharedClient ?? new CrmClient(config);
     return {
         crm_auth_status: async () => client.authStatus(),
         crm_list_modules: () => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wukongcrm/mcp-server",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Local and remote MCP server for fixed 72CRM API access.",
   "type": "module",
   "main": "./dist/index.js",