@wukongcrm/mcp-server 0.1.3

package/dist/server.js

@@ -0,0 +1,78 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { createToolHandlers } from "./tools.js";
+const moduleSchema = z.union([z.string(), z.number()]);
+const passthroughSchema = z.object({}).passthrough();
+const toolDefinitions = [
+    ["crm_auth_status", "使用 CRM_API_KEY 自动换取 Admin-Token 后检查当前登录态，异常时提示检查 API Key。", z.object({}).optional()],
+    ["crm_list_modules", "列出当前 MCP 固定支持的 72CRM 模块、label、路径和中英文操作边界。", z.object({}).optional()],
+    ["crm_list_customer_pools", "查询当前账号有权限访问的客户公海，并统计每个公海下面有多少客户；只读，不领取、不分配、不流转。", z.object({ includeSamples: z.boolean().optional(), sampleLimit: z.number().optional() }).passthrough()],
+    ["crm_get_module_schema", "获取模块字段结构和列表头，供本地 AI 判断字段怎么填。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]).optional() }).passthrough()],
+    ["crm_validate_field", "调用固定字段校验接口，校验字段值或联系人查重。", passthroughSchema],
+    ["crm_search_records", "查询模块分页列表；当传入 keyword/query/q/phone/mobile/name 等明显搜索语义时，会自动转换为 72CRM 高级筛选 searchList。", z.object({ module: moduleSchema, page: z.number().optional(), limit: z.number().optional() }).passthrough()],
+    ["crm_get_record", "按模块和 ID 查询单条 CRM 记录详情。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]) }).passthrough()],
+    ["crm_get_record_information", "查询详情页字段展示数据，包含字段中文名和值。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]) }).passthrough()],
+    ["crm_get_related_records", "查询固定白名单内的关联数据，例如商机产品、联系人商机、合同回款计划。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]), relation: z.string() }).passthrough()],
+    ["crm_get_record_timeline", "查询某条记录关联的跟进/活动时间线。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]) }).passthrough()],
+    ["crm_get_action_records", "查询某条记录的操作记录。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]) }).passthrough()],
+    ["crm_list_files", "只读查询附件元数据，不上传、不删除、不代理下载流。", z.object({ module: moduleSchema, id: z.union([z.string(), z.number()]) }).passthrough()],
+    ["crm_list_users", "查询员工列表。", passthroughSchema],
+    ["crm_find_user_id", "按登录名或真实姓名查询员工 ID。", z.object({ userName: z.string().optional(), name: z.string().optional(), mode: z.enum(["username", "realname"]).optional() }).passthrough()],
+    ["crm_list_departments", "查询部门树。", passthroughSchema],
+    ["crm_find_dept_id", "按部门名查询部门 ID。", z.object({ deptName: z.string().optional(), name: z.string().optional() }).passthrough()],
+    ["crm_preview_write", "写入前预览和校验，不调用 72CRM 写接口。", passthroughSchema],
+    ["crm_create_record", "新增线索、客户、联系人、商机；必须 confirm=true 才会写入。", z.object({ module: moduleSchema, confirm: z.boolean().optional() }).passthrough()],
+    ["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_add_followup", "新增跟进记录；必须 confirm=true 才会写入。", z.object({ confirm: z.boolean().optional() }).passthrough()],
+    ["crm_update_followup", "更新跟进记录；必须 confirm=true 才会写入。", z.object({ id: z.union([z.string(), z.number()]).optional(), confirm: z.boolean().optional() }).passthrough()]
+];
+export function createWukongMcpServer(config = {}) {
+    const server = new McpServer({
+        name: "@wukongcrm/mcp-server",
+        version: "0.1.3"
+    });
+    const handlers = createToolHandlers(config);
+    for (const [name, description, schema] of toolDefinitions) {
+        server.registerTool(name, {
+            title: name,
+            description,
+            inputSchema: schema
+        }, async (args) => {
+            try {
+                const result = await handlers[name](args ?? {});
+                return toToolText(result);
+            }
+            catch (error) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: sanitizeError(error)
+                        }
+                    ]
+                };
+            }
+        });
+    }
+    return server;
+}
+function toToolText(result) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2)
+            }
+        ]
+    };
+}
+function sanitizeError(error) {
+    let message = error instanceof Error ? error.message : String(error);
+    const apiKey = process.env.CRM_API_KEY;
+    if (apiKey && apiKey.length > 4) {
+        message = message.replaceAll(apiKey, "***");
+    }
+    return message;
+}

package/dist/tools.d.ts

@@ -0,0 +1,8 @@
+import { 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 {};