fmes-contact-mcp 0.1.0

package/src/tools/search-promoters.ts

@@ -0,0 +1,68 @@
+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 type SearchPromotersInput = z.infer<typeof searchPromotersSchema>;
+
+export async function searchPromoters(args: SearchPromotersInput, _extra?: unknown) {
+  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" as const, 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" as const, text: summary }],
+    structuredContent: result,
+  };
+}

package/src/tools/stats-promoters.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const statsPromotersSchema = z.object({
+  city: z.string().optional().describe("城市名称"),
+});
+
+export type StatsPromotersInput = z.infer<typeof statsPromotersSchema>;
+
+export async function statsPromoters(_args: StatsPromotersInput, _extra?: unknown) {
+  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" as const, text }],
+    structuredContent: result,
+  };
+}

package/src/types/index.ts

@@ -0,0 +1,98 @@
+// ========== 请求参数类型 ==========
+
+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/test/test-client.ts

@@ -0,0 +1,68 @@
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+import {
+  Client,
+} from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.resolve(__dirname, "..");
+
+async function main() {
+  const transport = new StdioClientTransport({
+    command: "node",
+    args: ["dist/index.js"],
+    cwd: projectRoot,
+  });
+
+  const client = new Client(
+    { name: "test-client", version: "1.0.0" },
+    { capabilities: {} }
+  );
+
+  await client.connect(transport);
+
+  const tools = await client.listTools();
+  console.log(`\n✅ 服务启动成功，发现 ${tools.tools.length} 个工具：\n`);
+  for (const tool of tools.tools) {
+    console.log(`  [${tool.name}] ${tool.description}`);
+  }
+
+  console.log("\n--- 测试 search_promoters ---\n");
+  try {
+    const result = await client.callTool({
+      name: "search_promoters",
+      arguments: { limit: 3 },
+    });
+    const content = result.content
+      .filter((c) => c.type === "text")
+      .map((c) => (c as { type: "text"; text: string }).text)
+      .join("\n");
+    console.log("返回结果:", content);
+  } catch (e) {
+    console.log("⚠️ 调用失败（可能 CRM 后端未启动）:", (e as Error).message);
+  }
+
+  console.log("\n--- 测试 stats_promoters ---\n");
+  try {
+    const result = await client.callTool({
+      name: "stats_promoters",
+      arguments: {},
+    });
+    const content = result.content
+      .filter((c) => c.type === "text")
+      .map((c) => (c as { type: "text"; text: string }).text)
+      .join("\n");
+    console.log("返回结果:", content);
+  } catch (e) {
+    console.log("⚠️ 调用失败（可能 CRM 后端未启动）:", (e as Error).message);
+  }
+
+  await client.close();
+}
+
+main().catch((err) => {
+  console.error("❌ 测试失败:", err.message);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}