fmes-contact-mcp 0.1.0 → 0.2.0

package/README.md

@@ -38,7 +38,29 @@ npm start
 
 ## Agent 接入配置
 
-编译完成后，在任意 MCP 兼容 Agent 中添加以下配置：
+在任意 MCP 兼容 Agent 中添加以下配置。
+
+### 方式一：npx 加载 npm 包（推荐，无需 clone）
+
+```json
+{
+  "mcpServers": {
+    "fmes-contact-mcp": {
+      "command": "npx",
+      "args": ["-y", "fmes-contact-mcp"],
+      "env": {
+        "CRM_BASE_URL": "http://你的服务器IP:8080/rest",
+        "CRM_USERNAME": "mt011",
+        "CRM_PASSWORD": "1"
+      }
+    }
+  }
+}
+```
+
+### 方式二：本地路径加载
+
+编译完成后使用本地 `dist/index.js`：
 
 ```json
 {
@@ -56,18 +78,44 @@ npm start
 }
 ```
 
-- `args` 填入实际的 `dist/index.js` 所在路径
-- `CRM_BASE_URL` 填入 CRM 后端的实际地址
+> `CRM_BASE_URL` 填入 CRM 后端的实际地址
 
 ## 发布到 npm（可选）
 
 发布后团队可用 `npx -y fmes-contact-mcp` 启动，无需 clone 仓库。
 
+### 首次发布
+
+1. 注册 npm 账号：https://www.npmjs.com/signup
+
+2. 登录：
+
 ```powershell
-# 首次需要登录
-npm login --registry=https://registry.npmjs.org
+npm login
+```
+
+弹出浏览器完成授权。
+
+3. 由于 npm 强制要求双因素认证（2FA）才能发布，需要创建免 2FA 的 Automation Token：
+
+   - 打开 https://www.npmjs.com → 头像 → **Access Tokens**
+   - 点 **Generate New Token** → 选 **Granular Access Token**
+   - Package & Scope：搜索 `fmes-contact-mcp`，选中
+   - Permissions：选 **Read and write**
+   - 勾选底部的 **"Bypass two-factor authentication"**
+   - 生成后复制 token
 
-# 发布
+4. 配置 token 并发布：
+
+```powershell
+npm config set //registry.npmjs.org/:_authToken=你的token
+npm publish --access public
+```
+
+### 后续更新发布
+
+```powershell
+npm run build
 npm publish
 ```
 

package/dist/client/crm-client.d.ts

@@ -8,6 +8,11 @@ declare class CrmClient {
     getPromoterDetail(empPk?: string, idcard?: string): Promise<PromoterInfo | null>;
     getContracts(params: SearchContractsParams): Promise<SearchContractsResult>;
     statsPromoters(): Promise<StatsResult>;
+    queryPositions(params: Record<string, unknown>): Promise<unknown>;
+    matchSalesmen(body: Record<string, unknown>): Promise<unknown>;
+    pushPositions(body: Record<string, unknown>): Promise<unknown>;
+    queryPushHistory(params: Record<string, unknown>): Promise<unknown>;
+    explainMatch(params: Record<string, unknown>): Promise<unknown>;
 }
 export declare const crmClient: CrmClient;
 export {};

package/dist/client/crm-client.js

@@ -121,6 +121,36 @@ class CrmClient {
         }
         return { total: list.length, groups, query: { groupBy: "status" } };
     }
+    async queryPositions(params) {
+        if (!this.loggedIn)
+            await this.login();
+        const res = await this.client.get("/aiRecommend/positions", { params });
+        return res.data;
+    }
+    async matchSalesmen(body) {
+        if (!this.loggedIn)
+            await this.login();
+        const res = await this.client.post("/aiRecommend/match", body);
+        return res.data;
+    }
+    async pushPositions(body) {
+        if (!this.loggedIn)
+            await this.login();
+        const res = await this.client.post("/aiRecommend/push", body);
+        return res.data;
+    }
+    async queryPushHistory(params) {
+        if (!this.loggedIn)
+            await this.login();
+        const res = await this.client.get("/aiRecommend/pushHistory", { params });
+        return res.data;
+    }
+    async explainMatch(params) {
+        if (!this.loggedIn)
+            await this.login();
+        const res = await this.client.get("/aiRecommend/explain", { params });
+        return res.data;
+    }
 }
 export const crmClient = new CrmClient();
 //# sourceMappingURL=crm-client.js.map

package/dist/client/crm-client.js.map

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

package/dist/index.d.ts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 import "dotenv/config";

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import "dotenv/config";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -6,9 +7,14 @@ import { getPromoterDetail, getPromoterDetailSchema, } from "./tools/get-promote
 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";
+import { queryPositions, queryPositionsSchema, } from "./tools/query-positions.js";
+import { matchSalesmen, matchSalesmenSchema, } from "./tools/match-salesmen.js";
+import { pushPositions, pushPositionsSchema, } from "./tools/push-positions.js";
+import { queryPushHistory, queryPushHistorySchema, } from "./tools/query-push-history.js";
+import { explainMatch, explainMatchSchema, } from "./tools/explain-match.js";
 const server = new McpServer({
     name: "fmes-contact-mcp",
-    version: "0.1.0",
+    version: "0.2.0",
 });
 server.registerTool("search_promoters", {
     description: "按多维度筛选触点（促销员），支持按地区、年龄、服务月数、项目数、星级、状态等条件筛选。",
@@ -30,6 +36,26 @@ server.registerTool("stats_promoters", {
     description: "触点统计概览，查看触点的分布情况（按状态、地区等维度）。",
     inputSchema: statsPromotersSchema,
 }, statsPromoters);
+server.registerTool("query_positions", {
+    description: "查询待推荐岗位列表，支持按门店名、岗位类型、区域、紧急程度筛选。",
+    inputSchema: queryPositionsSchema,
+}, queryPositions);
+server.registerTool("match_salesmen", {
+    description: "根据岗位匹配推荐促销员，返回推荐列表及评分详情。支持四维权重配置（距离、业绩、意愿、空闲）。",
+    inputSchema: matchSalesmenSchema,
+}, matchSalesmen);
+server.registerTool("push_positions", {
+    description: "将岗位推送给指定促销员，支持群发和指定推送。",
+    inputSchema: pushPositionsSchema,
+}, pushPositions);
+server.registerTool("query_push_history", {
+    description: "查询岗位推送历史记录，可按岗位、促销员、时间范围筛选。",
+    inputSchema: queryPushHistorySchema,
+}, queryPushHistory);
+server.registerTool("explain_match", {
+    description: "解释某个岗位对某个促销员的推荐理由和评分详情。",
+    inputSchema: explainMatchSchema,
+}, explainMatch);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;IACE,WAAW,EACT,6CAA6C;IAC/C,WAAW,EAAE,qBAAqB;CACnC,EACD,eAAe,CAChB,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;IACE,WAAW,EACT,iDAAiD;IACnD,WAAW,EAAE,uBAAuB;CACrC,EACD,iBAAiB,CAClB,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;IACE,WAAW,EACT,8CAA8C;IAChD,WAAW,EAAE,0BAA0B;CACxC,EACD,oBAAoB,CACrB,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;IACE,WAAW,EACT,wCAAwC;IAC1C,WAAW,EAAE,qBAAqB;CACnC,EACD,eAAe,CAChB,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;IACE,WAAW,EAAE,8BAA8B;IAC3C,WAAW,EAAE,oBAAoB;CAClC,EACD,cAAc,CACf,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/explain-match.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const explainMatchSchema: z.ZodObject<{
+    posStoreId: z.ZodNumber;
+    salesmanId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    posStoreId: number;
+    salesmanId: number;
+}, {
+    posStoreId: number;
+    salesmanId: number;
+}>;
+export type ExplainMatchInput = z.infer<typeof explainMatchSchema>;
+export declare function explainMatch(args: ExplainMatchInput, _extra?: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/tools/explain-match.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const explainMatchSchema = z.object({
+    posStoreId: z.number().int().describe("岗位门店ID"),
+    salesmanId: z.number().int().describe("促销员ID"),
+});
+export async function explainMatch(args, _extra) {
+    const data = await crmClient.explainMatch(args);
+    const text = JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: data,
+    };
+}
+//# sourceMappingURL=explain-match.js.map

package/dist/tools/explain-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-match.js","sourceRoot":"","sources":["../../src/tools/explain-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;CAC/C,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAuB,EACvB,MAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,YAAY,CACvC,IAA0C,CAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC"}

package/dist/tools/match-salesmen.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+export declare const matchSalesmenSchema: z.ZodObject<{
+    posStoreId: z.ZodNumber;
+    topN: z.ZodDefault<z.ZodNumber>;
+    weights: z.ZodOptional<z.ZodObject<{
+        distance: z.ZodDefault<z.ZodNumber>;
+        performance: z.ZodDefault<z.ZodNumber>;
+        willingness: z.ZodDefault<z.ZodNumber>;
+        availability: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        distance: number;
+        performance: number;
+        willingness: number;
+        availability: number;
+    }, {
+        distance?: number | undefined;
+        performance?: number | undefined;
+        willingness?: number | undefined;
+        availability?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    posStoreId: number;
+    topN: number;
+    weights?: {
+        distance: number;
+        performance: number;
+        willingness: number;
+        availability: number;
+    } | undefined;
+}, {
+    posStoreId: number;
+    topN?: number | undefined;
+    weights?: {
+        distance?: number | undefined;
+        performance?: number | undefined;
+        willingness?: number | undefined;
+        availability?: number | undefined;
+    } | undefined;
+}>;
+export type MatchSalesmenInput = z.infer<typeof matchSalesmenSchema>;
+export declare function matchSalesmen(args: MatchSalesmenInput, _extra?: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/tools/match-salesmen.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const matchSalesmenSchema = z.object({
+    posStoreId: z.number().int().describe("岗位门店ID"),
+    topN: z.number().int().default(20).describe("返回前N名候选人"),
+    weights: z
+        .object({
+        distance: z
+            .number()
+            .default(0.3)
+            .describe("距离权重: 门店与促销员住址的直线距离，越近得分越高"),
+        performance: z
+            .number()
+            .default(0.25)
+            .describe("历史表现权重: 促销员在同类岗位的历史业绩评分"),
+        willingness: z
+            .number()
+            .default(0.25)
+            .describe("意愿匹配权重: 促销员对该品类/门店的偏好程度"),
+        availability: z
+            .number()
+            .default(0.2)
+            .describe("在职状态权重: 促销员当前是否空闲可到岗"),
+    })
+        .optional()
+        .describe("四维评分权重配置，四个权重之和应等于1"),
+});
+export async function matchSalesmen(args, _extra) {
+    const data = await crmClient.matchSalesmen(args);
+    const text = JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: data,
+    };
+}
+//# sourceMappingURL=match-salesmen.js.map

package/dist/tools/match-salesmen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-salesmen.js","sourceRoot":"","sources":["../../src/tools/match-salesmen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IACvD,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,OAAO,CAAC,GAAG,CAAC;aACZ,QAAQ,CAAC,4BAA4B,CAAC;QACzC,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,yBAAyB,CAAC;QACtC,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,yBAAyB,CAAC;QACtC,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,OAAO,CAAC,GAAG,CAAC;aACZ,QAAQ,CAAC,sBAAsB,CAAC;KACpC,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAwB,EACxB,MAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,aAAa,CACxC,IAA0C,CAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC"}

package/dist/tools/push-positions.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const pushPositionsSchema: z.ZodObject<{
+    posStoreId: z.ZodNumber;
+    salesmanIds: z.ZodArray<z.ZodNumber, "many">;
+    pushType: z.ZodDefault<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    posStoreId: number;
+    salesmanIds: number[];
+    pushType: number;
+    message?: string | undefined;
+}, {
+    posStoreId: number;
+    salesmanIds: number[];
+    message?: string | undefined;
+    pushType?: number | undefined;
+}>;
+export type PushPositionsInput = z.infer<typeof pushPositionsSchema>;
+export declare function pushPositions(args: PushPositionsInput, _extra?: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/tools/push-positions.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const pushPositionsSchema = z.object({
+    posStoreId: z.number().int().describe("岗位门店ID"),
+    salesmanIds: z.array(z.number().int()).describe("推送的促销员ID列表"),
+    pushType: z
+        .number()
+        .int()
+        .default(2)
+        .describe("推送方式: 2=群发, 3=指定"),
+    message: z.string().optional().describe("附言"),
+});
+export async function pushPositions(args, _extra) {
+    const data = await crmClient.pushPositions(args);
+    const text = JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: data,
+    };
+}
+//# sourceMappingURL=push-positions.js.map

package/dist/tools/push-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-positions.js","sourceRoot":"","sources":["../../src/tools/push-positions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC7D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,kBAAkB,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;CAC9C,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAwB,EACxB,MAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,aAAa,CACxC,IAA0C,CAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC"}

package/dist/tools/query-positions.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export declare const queryPositionsSchema: z.ZodObject<{
+    storeName: z.ZodOptional<z.ZodString>;
+    posType: z.ZodOptional<z.ZodNumber>;
+    areaCode: z.ZodOptional<z.ZodString>;
+    areaName: z.ZodOptional<z.ZodString>;
+    urgent: z.ZodOptional<z.ZodBoolean>;
+    matchStatus: z.ZodOptional<z.ZodString>;
+    pageNo: z.ZodDefault<z.ZodNumber>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pageNo: number;
+    pageSize: number;
+    storeName?: string | undefined;
+    posType?: number | undefined;
+    areaCode?: string | undefined;
+    areaName?: string | undefined;
+    urgent?: boolean | undefined;
+    matchStatus?: string | undefined;
+}, {
+    storeName?: string | undefined;
+    posType?: number | undefined;
+    areaCode?: string | undefined;
+    areaName?: string | undefined;
+    urgent?: boolean | undefined;
+    matchStatus?: string | undefined;
+    pageNo?: number | undefined;
+    pageSize?: number | undefined;
+}>;
+export type QueryPositionsInput = z.infer<typeof queryPositionsSchema>;
+export declare function queryPositions(args: QueryPositionsInput, _extra?: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/tools/query-positions.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const queryPositionsSchema = z.object({
+    storeName: z.string().optional().describe("门店名或岗位名关键词"),
+    posType: z
+        .number()
+        .int()
+        .optional()
+        .describe("岗位类型: 1=长促, 2=短促"),
+    areaCode: z
+        .string()
+        .optional()
+        .describe("区域编码（精确匹配，对应CRM_DIV.AD_CODE）"),
+    areaName: z
+        .string()
+        .optional()
+        .describe("区域名称（模糊匹配，同时搜索AD_NAME/CITY_AD_NAME/PROVINCE_AD_NAME）"),
+    urgent: z.boolean().optional().describe("是否紧急岗位"),
+    matchStatus: z.string().optional().describe("匹配状态筛选"),
+    pageNo: z.number().int().default(1).describe("页码"),
+    pageSize: z.number().int().default(20).describe("每页数量"),
+});
+export async function queryPositions(args, _extra) {
+    const data = await crmClient.queryPositions(args);
+    const text = JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: data,
+    };
+}
+//# sourceMappingURL=query-positions.js.map

package/dist/tools/query-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-positions.js","sourceRoot":"","sources":["../../src/tools/query-positions.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,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACvD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;CACxD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAyB,EACzB,MAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,cAAc,CACzC,IAA0C,CAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC"}

package/dist/tools/query-push-history.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export declare const queryPushHistorySchema: z.ZodObject<{
+    posStoreId: z.ZodOptional<z.ZodNumber>;
+    salesmanId: z.ZodOptional<z.ZodNumber>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    pageNo: z.ZodDefault<z.ZodNumber>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pageNo: number;
+    pageSize: number;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    posStoreId?: number | undefined;
+    salesmanId?: number | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    pageNo?: number | undefined;
+    pageSize?: number | undefined;
+    posStoreId?: number | undefined;
+    salesmanId?: number | undefined;
+}>;
+export type QueryPushHistoryInput = z.infer<typeof queryPushHistorySchema>;
+export declare function queryPushHistory(args: QueryPushHistoryInput, _extra?: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;

package/dist/tools/query-push-history.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+export const queryPushHistorySchema = z.object({
+    posStoreId: z.number().int().optional().describe("岗位门店ID"),
+    salesmanId: z.number().int().optional().describe("促销员ID"),
+    startDate: z.string().optional().describe("开始日期 YYYY-MM-DD"),
+    endDate: z.string().optional().describe("结束日期 YYYY-MM-DD"),
+    pageNo: z.number().int().default(1).describe("页码"),
+    pageSize: z.number().int().default(20).describe("每页数量"),
+});
+export async function queryPushHistory(args, _extra) {
+    const data = await crmClient.queryPushHistory(args);
+    const text = JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: data,
+    };
+}
+//# sourceMappingURL=query-push-history.js.map

package/dist/tools/query-push-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-push-history.js","sourceRoot":"","sources":["../../src/tools/query-push-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;CACxD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA2B,EAC3B,MAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAC3C,IAA0C,CAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "fmes-contact-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "触点推荐 MCP Server - 为企业 AI Agent 提供促销员智能推荐",
   "type": "module",
   "main": "dist/index.js",
+  "bin": "./dist/index.js",
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",

package/src/client/crm-client.ts

@@ -130,6 +130,36 @@ class CrmClient {
 
     return { total: list.length, groups, query: { groupBy: "status" } };
   }
+
+  async queryPositions(params: Record<string, unknown>): Promise<unknown> {
+    if (!this.loggedIn) await this.login();
+    const res = await this.client.get("/aiRecommend/positions", { params });
+    return res.data;
+  }
+
+  async matchSalesmen(body: Record<string, unknown>): Promise<unknown> {
+    if (!this.loggedIn) await this.login();
+    const res = await this.client.post("/aiRecommend/match", body);
+    return res.data;
+  }
+
+  async pushPositions(body: Record<string, unknown>): Promise<unknown> {
+    if (!this.loggedIn) await this.login();
+    const res = await this.client.post("/aiRecommend/push", body);
+    return res.data;
+  }
+
+  async queryPushHistory(params: Record<string, unknown>): Promise<unknown> {
+    if (!this.loggedIn) await this.login();
+    const res = await this.client.get("/aiRecommend/pushHistory", { params });
+    return res.data;
+  }
+
+  async explainMatch(params: Record<string, unknown>): Promise<unknown> {
+    if (!this.loggedIn) await this.login();
+    const res = await this.client.get("/aiRecommend/explain", { params });
+    return res.data;
+  }
 }
 
 export const crmClient = new CrmClient();

package/src/index.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import "dotenv/config";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -21,10 +22,30 @@ import {
   statsPromoters,
   statsPromotersSchema,
 } from "./tools/stats-promoters.js";
+import {
+  queryPositions,
+  queryPositionsSchema,
+} from "./tools/query-positions.js";
+import {
+  matchSalesmen,
+  matchSalesmenSchema,
+} from "./tools/match-salesmen.js";
+import {
+  pushPositions,
+  pushPositionsSchema,
+} from "./tools/push-positions.js";
+import {
+  queryPushHistory,
+  queryPushHistorySchema,
+} from "./tools/query-push-history.js";
+import {
+  explainMatch,
+  explainMatchSchema,
+} from "./tools/explain-match.js";
 
 const server = new McpServer({
   name: "fmes-contact-mcp",
-  version: "0.1.0",
+  version: "0.2.0",
 });
 
 server.registerTool(
@@ -76,6 +97,53 @@ server.registerTool(
   statsPromoters
 );
 
+server.registerTool(
+  "query_positions",
+  {
+    description:
+      "查询待推荐岗位列表，支持按门店名、岗位类型、区域、紧急程度筛选。",
+    inputSchema: queryPositionsSchema,
+  },
+  queryPositions
+);
+
+server.registerTool(
+  "match_salesmen",
+  {
+    description:
+      "根据岗位匹配推荐促销员，返回推荐列表及评分详情。支持四维权重配置（距离、业绩、意愿、空闲）。",
+    inputSchema: matchSalesmenSchema,
+  },
+  matchSalesmen
+);
+
+server.registerTool(
+  "push_positions",
+  {
+    description: "将岗位推送给指定促销员，支持群发和指定推送。",
+    inputSchema: pushPositionsSchema,
+  },
+  pushPositions
+);
+
+server.registerTool(
+  "query_push_history",
+  {
+    description: "查询岗位推送历史记录，可按岗位、促销员、时间范围筛选。",
+    inputSchema: queryPushHistorySchema,
+  },
+  queryPushHistory
+);
+
+server.registerTool(
+  "explain_match",
+  {
+    description: "解释某个岗位对某个促销员的推荐理由和评分详情。",
+    inputSchema: explainMatchSchema,
+  },
+  explainMatch
+);
+
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/src/tools/explain-match.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const explainMatchSchema = z.object({
+  posStoreId: z.number().int().describe("岗位门店ID"),
+  salesmanId: z.number().int().describe("促销员ID"),
+});
+
+export type ExplainMatchInput = z.infer<typeof explainMatchSchema>;
+
+export async function explainMatch(
+  args: ExplainMatchInput,
+  _extra?: unknown
+) {
+  const data = await crmClient.explainMatch(
+    args as unknown as Record<string, unknown>
+  );
+
+  const text = JSON.stringify(data, null, 2);
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: data as Record<string, unknown>,
+  };
+}

package/src/tools/match-salesmen.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const matchSalesmenSchema = z.object({
+  posStoreId: z.number().int().describe("岗位门店ID"),
+  topN: z.number().int().default(20).describe("返回前N名候选人"),
+  weights: z
+    .object({
+      distance: z
+        .number()
+        .default(0.3)
+        .describe("距离权重: 门店与促销员住址的直线距离，越近得分越高"),
+      performance: z
+        .number()
+        .default(0.25)
+        .describe("历史表现权重: 促销员在同类岗位的历史业绩评分"),
+      willingness: z
+        .number()
+        .default(0.25)
+        .describe("意愿匹配权重: 促销员对该品类/门店的偏好程度"),
+      availability: z
+        .number()
+        .default(0.2)
+        .describe("在职状态权重: 促销员当前是否空闲可到岗"),
+    })
+    .optional()
+    .describe("四维评分权重配置，四个权重之和应等于1"),
+});
+
+export type MatchSalesmenInput = z.infer<typeof matchSalesmenSchema>;
+
+export async function matchSalesmen(
+  args: MatchSalesmenInput,
+  _extra?: unknown
+) {
+  const data = await crmClient.matchSalesmen(
+    args as unknown as Record<string, unknown>
+  );
+
+  const text = JSON.stringify(data, null, 2);
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: data as Record<string, unknown>,
+  };
+}

package/src/tools/push-positions.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const pushPositionsSchema = z.object({
+  posStoreId: z.number().int().describe("岗位门店ID"),
+  salesmanIds: z.array(z.number().int()).describe("推送的促销员ID列表"),
+  pushType: z
+    .number()
+    .int()
+    .default(2)
+    .describe("推送方式: 2=群发, 3=指定"),
+  message: z.string().optional().describe("附言"),
+});
+
+export type PushPositionsInput = z.infer<typeof pushPositionsSchema>;
+
+export async function pushPositions(
+  args: PushPositionsInput,
+  _extra?: unknown
+) {
+  const data = await crmClient.pushPositions(
+    args as unknown as Record<string, unknown>
+  );
+
+  const text = JSON.stringify(data, null, 2);
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: data as Record<string, unknown>,
+  };
+}

package/src/tools/query-positions.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const queryPositionsSchema = z.object({
+  storeName: z.string().optional().describe("门店名或岗位名关键词"),
+  posType: z
+    .number()
+    .int()
+    .optional()
+    .describe("岗位类型: 1=长促, 2=短促"),
+  areaCode: z
+    .string()
+    .optional()
+    .describe("区域编码（精确匹配，对应CRM_DIV.AD_CODE）"),
+  areaName: z
+    .string()
+    .optional()
+    .describe("区域名称（模糊匹配，同时搜索AD_NAME/CITY_AD_NAME/PROVINCE_AD_NAME）"),
+  urgent: z.boolean().optional().describe("是否紧急岗位"),
+  matchStatus: z.string().optional().describe("匹配状态筛选"),
+  pageNo: z.number().int().default(1).describe("页码"),
+  pageSize: z.number().int().default(20).describe("每页数量"),
+});
+
+export type QueryPositionsInput = z.infer<typeof queryPositionsSchema>;
+
+export async function queryPositions(
+  args: QueryPositionsInput,
+  _extra?: unknown
+) {
+  const data = await crmClient.queryPositions(
+    args as unknown as Record<string, unknown>
+  );
+
+  const text = JSON.stringify(data, null, 2);
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: data as Record<string, unknown>,
+  };
+}

package/src/tools/query-push-history.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { crmClient } from "../client/crm-client.js";
+
+export const queryPushHistorySchema = z.object({
+  posStoreId: z.number().int().optional().describe("岗位门店ID"),
+  salesmanId: z.number().int().optional().describe("促销员ID"),
+  startDate: z.string().optional().describe("开始日期 YYYY-MM-DD"),
+  endDate: z.string().optional().describe("结束日期 YYYY-MM-DD"),
+  pageNo: z.number().int().default(1).describe("页码"),
+  pageSize: z.number().int().default(20).describe("每页数量"),
+});
+
+export type QueryPushHistoryInput = z.infer<typeof queryPushHistorySchema>;
+
+export async function queryPushHistory(
+  args: QueryPushHistoryInput,
+  _extra?: unknown
+) {
+  const data = await crmClient.queryPushHistory(
+    args as unknown as Record<string, unknown>
+  );
+
+  const text = JSON.stringify(data, null, 2);
+
+  return {
+    content: [{ type: "text" as const, text }],
+    structuredContent: data as Record<string, unknown>,
+  };
+}