fmes-contact-mcp 0.1.0

package/dist/tools/search-promoters.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const searchPromotersSchema = z.object({
+    name: z.string().optional().describe("触点姓名"),
+    idcard: z.string().optional().describe("身份证号"),
+    tel: z.string().optional().describe("手机号"),
+    empPk: z.string().optional().describe("促销员ID（米咖ID或普洛特ID）"),
+    province: z.string().optional().describe("省份名称，如：北京、上海"),
+    city: z.string().optional().describe("城市名称，如：北京、上海、广州"),
+    area: z.string().optional().describe("区县名称"),
+    sex: z.number().int().min(0).max(1).optional().describe("性别（0=女, 1=男）"),
+    ageMin: z.number().int().min(18).max(70).optional().describe("最小年龄"),
+    ageMax: z.number().int().min(18).max(70).optional().describe("最大年龄"),
+    workMonthMin: z.number().int().min(0).optional().describe("最少服务月数"),
+    projectNumMin: z.number().int().min(0).optional().describe("最少项目数"),
+    status: z
+        .enum(["项目中", "在岗", "待岗中"])
+        .optional()
+        .describe("项目状态"),
+    limit: z.number().int().min(1).max(50).default(10).describe("返回数量上限"),
+});
+export async function searchPromoters(args, _extra) {
+    const result = await crmClient.searchPromoters({
+        name: args.name,
+        idcard: args.idcard,
+        tel: args.tel,
+        empPk: args.empPk,
+        province: args.province,
+        city: args.city,
+        area: args.area,
+        sex: args.sex,
+        ageMin: args.ageMin,
+        ageMax: args.ageMax,
+        workMonthMin: args.workMonthMin,
+        projectNumMin: args.projectNumMin,
+        status: args.status,
+        limit: args.limit,
+    });
+    if (result.list.length === 0) {
+        return {
+            content: [{ type: "text", text: "未找到符合条件的触点。" }],
+        };
+    }
+    const summary = `找到 ${result.total} 个触点，以下是前 ${result.list.length} 个：\n\n` +
+        result.list
+            .map((p, i) => `${i + 1}. ${p.name} | 米咖ID: ${p.empPk} | 性别: ${p.sex === 1 ? "男" : "女"} | 年龄: ${p.age} | ` +
+            `地区: ${p.province || ""}${p.city || ""}${p.area || ""} | 状态: ${p.status || "未知"} | ` +
+            `服务月数: ${p.workMonth || 0} | 项目数: ${p.projectNum || 0}`)
+            .join("\n") +
+        (result.total > result.list.length
+            ? `\n\n（共 ${result.total} 条，已截取前 ${result.list.length} 条，可缩小筛选条件或调整 limit）`
+            : "");
+    return {
+        content: [{ type: "text", text: summary }],
+        structuredContent: result,
+    };
+}
+//# sourceMappingURL=search-promoters.js.map

package/dist/tools/search-promoters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-promoters.js","sourceRoot":"","sources":["../../src/tools/search-promoters.ts"],"names":[],"mappings":"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"}

package/dist/tools/stats-promoters.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const statsPromotersSchema: z.ZodObject<{
+    city: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    city?: string | undefined;
+}, {
+    city?: string | undefined;
+}>;
+export type StatsPromotersInput = z.infer<typeof statsPromotersSchema>;
+export declare function statsPromoters(_args: StatsPromotersInput, _extra?: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: import("../types/index.js").StatsResult;
+}>;

package/dist/tools/stats-promoters.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const statsPromotersSchema = z.object({
+    city: z.string().optional().describe("城市名称"),
+});
+export async function statsPromoters(_args, _extra) {
+    const result = await crmClient.statsPromoters();
+    const text = `触点统计概览（共 ${result.total} 人）\n\n` +
+        `按项目状态分布：\n` +
+        result.groups
+            .map((g) => `  ${g.key}: ${g.count}人（${g.percentage}）`)
+            .join("\n") +
+        `\n\n提示：可按地区进一步筛选，使用 search_promoters 工具指定 city 参数。`;
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: result,
+    };
+}
+//# sourceMappingURL=stats-promoters.js.map

package/dist/tools/stats-promoters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-promoters.js","sourceRoot":"","sources":["../../src/tools/stats-promoters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;CAC7C,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B,EAAE,MAAgB;IAC/E,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,IAAI,GACR,YAAY,MAAM,CAAC,KAAK,SAAS;QACjC,YAAY;QACZ,MAAM,CAAC,MAAM;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC;aACtD,IAAI,CAAC,IAAI,CAAC;QACb,oDAAoD,CAAC;IAEvD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,MAAM;KAC1B,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,87 @@
+export interface SearchPromotersParams {
+    name?: string;
+    idcard?: string;
+    tel?: string;
+    empPk?: string;
+    province?: string;
+    city?: string;
+    area?: string;
+    sex?: number;
+    ageMin?: number;
+    ageMax?: number;
+    workMonthMin?: number;
+    projectNumMin?: number;
+    status?: string;
+    limit: number;
+}
+export interface SearchContractsParams {
+    idcard?: string;
+    empPk?: string;
+    contractType?: "1" | "2";
+    limit: number;
+}
+export interface StatsPromotersParams {
+    province?: string;
+    city?: string;
+    groupBy: "age" | "region" | "status";
+}
+export interface PromoterInfo {
+    [key: string]: unknown;
+    name: string;
+    sex: number;
+    age: number;
+    tel: string;
+    idcard: string;
+    empPk: string;
+    province: string;
+    city: string;
+    area: string;
+    homeAddress: string;
+    bank: string;
+    bankNum: string;
+    projectNum: number;
+    workMonth: number;
+    status: string;
+    registerTime: string;
+    isAuthentication: number;
+}
+export interface McpContractInfo {
+    [key: string]: unknown;
+    contractType: string;
+    source: string;
+    customer: string;
+    serviceSupplier: string;
+    merchantName: string;
+    signedTime: string;
+    startTime: string;
+    endTime: string;
+    taskName: string;
+    clientId: string;
+    contractTypeId: string;
+    startDate: string;
+    endDate: string;
+    contractNumber: string;
+    contractStatus: string;
+}
+export interface SearchPromotersResult {
+    [key: string]: unknown;
+    total: number;
+    list: PromoterInfo[];
+    query: Partial<SearchPromotersParams>;
+}
+export interface SearchContractsResult {
+    [key: string]: unknown;
+    total: number;
+    list: McpContractInfo[];
+    query: Partial<SearchContractsParams>;
+}
+export interface StatsResult {
+    [key: string]: unknown;
+    query: Partial<StatsPromotersParams>;
+    total: number;
+    groups: Array<{
+        key: string;
+        count: number;
+        percentage: string;
+    }>;
+}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// ========== 请求参数类型 ==========
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,+BAA+B"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "fmes-contact-mcp",
+  "version": "0.1.0",
+  "description": "触点推荐 MCP Server - 为企业 AI Agent 提供促销员智能推荐",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.7.0",
+    "axios-cookiejar-support": "^7.0.0",
+    "dotenv": "^17.4.2",
+    "tough-cookie": "^6.0.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.22.4",
+    "typescript": "^5.5.0"
+  }
+}

package/src/client/crm-client.ts

@@ -0,0 +1,135 @@
+import axios, { AxiosInstance } from "axios";
+import { wrapper } from "axios-cookiejar-support";
+import { CookieJar } from "tough-cookie";
+import {
+  SearchPromotersParams,
+  SearchPromotersResult,
+  SearchContractsParams,
+  SearchContractsResult,
+  StatsResult,
+  PromoterInfo,
+  McpContractInfo,
+} from "../types/index.js";
+
+const CRM_BASE_URL = process.env.CRM_BASE_URL || "http://localhost:8080/rest";
+const CRM_USERNAME = process.env.CRM_USERNAME || "";
+const CRM_PASSWORD = process.env.CRM_PASSWORD || "";
+
+class CrmClient {
+  private client: AxiosInstance;
+  private loggedIn: boolean = false;
+
+  constructor() {
+    const jar = new CookieJar();
+    this.client = wrapper(
+      axios.create({
+        baseURL: CRM_BASE_URL,
+        timeout: 30000,
+        headers: { "Content-Type": "application/json" },
+        jar,
+        withCredentials: true,
+      })
+    );
+  }
+
+  async login(): Promise<void> {
+    const res = await this.client.get("/sysUser/sysUserLogin", {
+      params: { account: CRM_USERNAME, password: CRM_PASSWORD },
+    });
+    if (res.status === 200) {
+      this.loggedIn = true;
+    } else {
+      throw new Error(`登录失败: ${res.status} ${res.statusText}`);
+    }
+  }
+
+  async searchPromoters(
+    params: SearchPromotersParams
+  ): Promise<SearchPromotersResult> {
+    if (!this.loggedIn) await this.login();
+
+    const body: Record<string, unknown> = {
+      limit: params.limit,
+    };
+    if (params.name) body.name = params.name;
+    if (params.idcard) body.idcard = params.idcard;
+    if (params.tel) body.tel = params.tel;
+    if (params.empPk) body.empPk = params.empPk;
+    if (params.province) body.province = params.province;
+    if (params.city) body.city = params.city;
+    if (params.area) body.area = params.area;
+    if (params.sex !== undefined) body.sex = params.sex;
+    if (params.ageMin !== undefined) body.ageMin = params.ageMin;
+    if (params.ageMax !== undefined) body.ageMax = params.ageMax;
+    if (params.workMonthMin !== undefined) body.workMonthMin = params.workMonthMin;
+    if (params.projectNumMin !== undefined) body.projectNumMin = params.projectNumMin;
+    if (params.status) body.status = params.status;
+
+    const res = await this.client.post("/mcp/salesman/search", body);
+    const data = res.data as { data: PromoterInfo[] };
+    const list = data.data || [];
+    return {
+      total: list.length,
+      list,
+      query: params,
+    };
+  }
+
+  async getPromoterDetail(empPk?: string, idcard?: string): Promise<PromoterInfo | null> {
+    if (!this.loggedIn) await this.login();
+
+    const body: Record<string, unknown> = {};
+    if (empPk) body.empPk = empPk;
+    if (idcard) body.idcard = idcard;
+
+    const res = await this.client.post("/mcp/salesman/detail", body);
+    const data = res.data as { data: PromoterInfo };
+    return data.data || null;
+  }
+
+  async getContracts(
+    params: SearchContractsParams
+  ): Promise<SearchContractsResult> {
+    if (!this.loggedIn) await this.login();
+
+    const body: Record<string, unknown> = {};
+    if (params.idcard) body.idcard = params.idcard;
+    if (params.empPk) body.empPk = params.empPk;
+    if (params.contractType) body.contractType = params.contractType;
+
+    const res = await this.client.post("/mcp/salesman/contract/search", body);
+    const data = res.data as { data: { list: McpContractInfo[]; total: number } };
+    const result = data.data || { list: [], total: 0 };
+    return {
+      total: result.total,
+      list: result.list,
+      query: params,
+    };
+  }
+
+  async statsPromoters(): Promise<StatsResult> {
+    if (!this.loggedIn) await this.login();
+
+    const res = await this.client.post("/mcp/salesman/search", { limit: 500 });
+    const data = res.data as { data: PromoterInfo[] };
+    const list = data.data || [];
+
+    const groups: StatsResult["groups"] = [];
+    const groupMap = new Map<string, number>();
+    for (const p of list) {
+      const key = p.status || "未知";
+      groupMap.set(key, (groupMap.get(key) || 0) + 1);
+    }
+    for (const [key, count] of groupMap) {
+      groups.push({
+        key,
+        count,
+        percentage: list.length > 0 ? ((count / list.length) * 100).toFixed(1) + "%" : "0%",
+      });
+    }
+
+    return { total: list.length, groups, query: { groupBy: "status" } };
+  }
+}
+
+export const crmClient = new CrmClient();

package/src/index.ts

@@ -0,0 +1,88 @@
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  searchPromoters,
+  searchPromotersSchema,
+} from "./tools/search-promoters.js";
+import {
+  getPromoterDetail,
+  getPromoterDetailSchema,
+} from "./tools/get-promoter-detail.js";
+import {
+  getPromoterContracts,
+  getPromoterContractsSchema,
+} from "./tools/get-promoter-contracts.js";
+import {
+  searchContracts,
+  searchContractsSchema,
+} from "./tools/search-contracts.js";
+import {
+  statsPromoters,
+  statsPromotersSchema,
+} from "./tools/stats-promoters.js";
+
+const server = new McpServer({
+  name: "fmes-contact-mcp",
+  version: "0.1.0",
+});
+
+server.registerTool(
+  "search_promoters",
+  {
+    description:
+      "按多维度筛选触点（促销员），支持按地区、年龄、服务月数、项目数、星级、状态等条件筛选。",
+    inputSchema: searchPromotersSchema,
+  },
+  searchPromoters
+);
+
+server.registerTool(
+  "get_promoter_detail",
+  {
+    description:
+      "获取指定触点的详细信息，包括姓名、身份证号、手机号、银行卡、星级、信用分、项目数、服务月数等。",
+    inputSchema: getPromoterDetailSchema,
+  },
+  getPromoterDetail
+);
+
+server.registerTool(
+  "get_promoter_contracts",
+  {
+    description:
+      "查询某个触点的所有合同信息，包括长促合同和灵工合同，返回客户名称、签约平台、合同期限等。",
+    inputSchema: getPromoterContractsSchema,
+  },
+  getPromoterContracts
+);
+
+server.registerTool(
+  "search_contracts",
+  {
+    description:
+      "按合同维度搜索，支持按身份证号、客户名称、签约平台、合同类型、时间范围筛选。",
+    inputSchema: searchContractsSchema,
+  },
+  searchContracts
+);
+
+server.registerTool(
+  "stats_promoters",
+  {
+    description: "触点统计概览，查看触点的分布情况（按状态、地区等维度）。",
+    inputSchema: statsPromotersSchema,
+  },
+  statsPromoters
+);
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("fmes-contact-mcp Server 已启动，等待连接...");
+}
+
+main().catch((err) => {
+  console.error("启动失败:", err);
+  process.exit(1);
+});

package/src/tools/get-promoter-contracts.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+import type { McpContractInfo } from "../types/index.js";
+
+export const getPromoterContractsSchema = z.object({
+  empPk: z.string().describe("触点促销员ID（米咖ID）"),
+  contractType: z
+    .enum(["1", "2"])
+    .optional()
+    .describe("合同类型（1=灵工合同, 2=长促合同），不传则查全部"),
+});
+
+export type GetPromoterContractsInput = z.infer<
+  typeof getPromoterContractsSchema
+>;
+
+export async function getPromoterContracts(args: GetPromoterContractsInput, _extra?: unknown) {
+  const promoter = await crmClient.getPromoterDetail(args.empPk);
+
+  if (!promoter) {
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `未找到促销员ID为 ${args.empPk} 的触点。`,
+        },
+      ],
+    };
+  }
+
+  const result = await crmClient.getContracts({
+    empPk: args.empPk,
+    contractType: args.contractType,
+    limit: 100,
+  });
+
+  const linggongList = result.list.filter((c) => c.contractType === "1");
+  const changcuList = result.list.filter((c) => c.contractType === "2");
+
+  const formatContract = (c: McpContractInfo, i: number) => {
+    const typeLabel = c.contractType === "1" ? "灵工" : "长促";
+    const sourceLabel = c.source ? `(${c.source})` : "";
+    return (
+      `${i + 1}. [${typeLabel}${sourceLabel}] 客户: ${c.customer || "未知"} | ` +
+      `签约时间: ${c.signedTime || "未知"} | 有效期: ${c.startTime || "?"} ~ ${c.endTime || "?"} | ` +
+      `状态: ${c.contractStatus || "未知"}`
+    );
+  };
+
+  const text =
+    `触点：${promoter.name}（${args.empPk}）的合同信息\n\n` +
+    `=== 灵工合同（${linggongList.length} 份）===\n` +
+    (linggongList.length === 0
+      ? "无灵工合同记录\n"
+      : linggongList.map((c, i) => formatContract(c, i)).join("\n") + "\n") +
+    `\n=== 长促合同（${changcuList.length} 份）===\n` +
+    (changcuList.length === 0
+      ? "无长促合同记录"
+      : changcuList.map((c, i) => formatContract(c, i)).join("\n"));
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: {
+      promoter,
+      linggongContracts: linggongList,
+      changcuContracts: changcuList,
+    },
+  };
+}

package/src/tools/get-promoter-detail.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const getPromoterDetailSchema = z.object({
+  empPk: z.string().describe("触点促销员ID（米咖ID）"),
+});
+
+export type GetPromoterDetailInput = z.infer<typeof getPromoterDetailSchema>;
+
+export async function getPromoterDetail(args: GetPromoterDetailInput, _extra?: unknown) {
+  const p = await crmClient.getPromoterDetail(args.empPk);
+
+  if (!p) {
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `未找到促销员ID为 ${args.empPk} 的触点。`,
+        },
+      ],
+    };
+  }
+
+  const sexLabel = p.sex === 1 ? "男" : p.sex === 0 ? "女" : "未知";
+  const authLabel = p.isAuthentication === 1 ? "已认证" : "未认证";
+
+  const detail =
+    `姓名：${p.name}\n` +
+    `米咖ID：${p.empPk}\n` +
+    `性别：${sexLabel}\n` +
+    `年龄：${p.age}岁\n` +
+    `身份证号：${p.idcard}\n` +
+    `手机号：${p.tel}\n` +
+    `地区：${p.province || ""}${p.city || ""}${p.area || ""}\n` +
+    `地址：${p.homeAddress || "未知"}\n` +
+    `状态：${p.status || "未知"}\n` +
+    `项目数：${p.projectNum || 0}个\n` +
+    `服务月数：${p.workMonth || 0}个月\n` +
+    `开户行：${p.bank || "未知"}\n` +
+    `银行卡号：${p.bankNum || "未知"}\n` +
+    `注册时间：${p.registerTime || "未知"}\n` +
+    `实名认证：${authLabel}`;
+
+  return {
+    content: [{ type: "text" as const, text: detail }],
+    structuredContent: p,
+  };
+}

package/src/tools/search-contracts.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+import type { McpContractInfo } from "../types/index.js";
+
+export const searchContractsSchema = z.object({
+  idcard: z.string().optional().describe("身份证号"),
+  empPk: z.string().optional().describe("促销员ID（米咖ID）"),
+  contractType: z
+    .enum(["1", "2"])
+    .optional()
+    .describe("合同类型（1=灵工合同, 2=长促合同），不传则查全部"),
+  limit: z.number().int().min(1).max(50).default(10).describe("返回数量上限"),
+});
+
+export type SearchContractsInput = z.infer<typeof searchContractsSchema>;
+
+export async function searchContracts(args: SearchContractsInput, _extra?: unknown) {
+  if (!args.idcard && !args.empPk) {
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: "请至少提供身份证号或促销员ID中的一个条件。",
+        },
+      ],
+    };
+  }
+
+  const result = await crmClient.getContracts({
+    idcard: args.idcard,
+    empPk: args.empPk,
+    contractType: args.contractType,
+    limit: args.limit,
+  });
+
+  if (result.list.length === 0) {
+    return {
+      content: [
+        { type: "text" as const, text: "未找到符合条件的合同记录。" },
+      ],
+    };
+  }
+
+  const formatContract = (c: McpContractInfo, i: number) => {
+    const typeLabel = c.contractType === "1" ? "灵工" : "长促";
+    const sourceLabel = c.source ? `(${c.source})` : "";
+    return (
+      `${i + 1}. [${typeLabel}${sourceLabel}] 客户: ${c.customer || "未知"} | ` +
+      `签约时间: ${c.signedTime || "未知"} | 有效期: ${c.startTime || "?"} ~ ${c.endTime || "?"} | ` +
+      `状态: ${c.contractStatus || "未知"}`
+    );
+  };
+
+  const text =
+    `找到 ${result.total} 条合同记录：\n\n` +
+    result.list.map((c, i) => formatContract(c, i)).join("\n");
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: result,
+  };
+}