yuqing-fullsearch-mcp 1.0.0

package/README.md

@@ -0,0 +1,64 @@
+# yuqing-fullsearch-mcp
+
+国内舆情全文检索 MCP Server，供 Cursor、Kilo Code 等支持 MCP 的客户端调用。
+
+## 功能
+
+- **fullsearch_information_list**：全文检索舆情，支持 keyword、时间范围、行业/事件/省份/城市等筛选。
+- **yuqing_industry_list**：获取行业列表，用于结果过多时按行业二次筛选。
+- **yuqing_event_list**：获取事件列表，用于结果过多时按事件二次筛选。
+
+## 安装
+
+```bash
+npm install -g yuqing-fullsearch-mcp
+```
+
+或使用 npx 直接运行（无需全局安装）：
+
+```bash
+npx yuqing-fullsearch-mcp
+```
+
+## 在 MCP 客户端中配置
+
+### Cursor / Kilo Code（mcp.json）
+
+```json
+{
+  "mcpServers": {
+    "yuqing-fullsearch": {
+      "command": "npx",
+      "args": ["-y", "yuqing-fullsearch-mcp"],
+      "env": {},
+      "alwaysAllow": ["*", "fullsearch_information_list", "yuqing_industry_list", "yuqing_event_list"]
+    }
+  }
+}
+```
+
+若使用本地项目路径方式（不发布到 npm 时）：
+
+```json
+{
+  "yuqing-fullsearch": {
+    "command": "npm",
+    "args": ["run", "start", "--prefix", "path/to/yuqing-mcp"],
+    "alwaysAllow": ["*"]
+  }
+}
+```
+
+## 接口说明
+
+- 检索接口基础地址：`https://stonedtapi-w.bu3skq6y.hqxin.net`
+- **keyword** 中不要包含省份、城市，省份填 `province`，城市填 `city`。
+- 调用 **fullsearch_information_list** 时建议适当加大 `page_size`（如 30），写入采集文档前请先筛选有用内容。
+
+## 要求
+
+- Node.js >= 18
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "yuqing-fullsearch-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for 国内舆情全文检索：fullsearch_information_list、yuqing_industry_list、yuqing_event_list",
+  "type": "module",
+  "main": "server.js",
+  "bin": {
+    "yuqing-fullsearch-mcp": "server.js",
+    "yuqing-mcp": "server.js"
+  },
+  "scripts": {
+    "start": "node server.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "yuqing",
+    "舆情",
+    "全文检索",
+    "fullsearch"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "server.js"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}

package/server.js

@@ -0,0 +1,411 @@
+#!/usr/bin/env node
+/**
+ * 国内舆情全文检索 MCP Server (Node.js)
+ * 暴露 fullsearch_information_list 工具
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const BASE_URL = "https://stonedtapi-w.bu3skq6y.hqxin.net";
+
+async function fetchApi(path, options = {}) {
+  const url = `${BASE_URL}${path}`;
+  const { method = "GET", body } = options;
+  try {
+    const init = {
+      method,
+      headers: {
+        "User-Agent":
+          "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+      },
+      signal: AbortSignal.timeout(15000),
+    };
+    if (body !== undefined && (method === "POST" || method === "PUT")) {
+      init.headers["Content-Type"] = "application/json";
+      init.body = typeof body === "string" ? body : JSON.stringify(body || {});
+    }
+    const res = await fetch(url, init);
+    const text = await res.text();
+    if (!text || !text.trim()) return { code: res.status, message: "Empty response", data: null };
+    const first = text.trim()[0];
+    if (first === "{" || first === "[") {
+      try {
+        return JSON.parse(text);
+      } catch (_) {
+        return { code: -1, message: "Invalid JSON", data: null };
+      }
+    }
+    return { code: res.status, message: "Response is not JSON (e.g. HTML)", data: null };
+  } catch (e) {
+    return { code: -1, message: e.message, data: null };
+  }
+}
+
+/** 获取行业列表。BASE_URL + /industry，POST，请求体格式以实际接口为准 */
+async function getIndustryList() {
+  const body = {
+    times: "",
+    timee: "",
+    page: 1,
+    searchType: 1,
+    similar: 0,
+    matchingmode: 1,
+    emotionalIndex: [1, 2, 3],
+    province: [],
+    city: [],
+    eventIndex: [],
+    industryIndex: [],
+    searchword: "",
+    timeType: 4,
+    organizationtype: ["0"],
+    categorylabledata: ["0"],
+    enterprisetypelist: ["0"],
+    hightechtypelist: ["0"],
+    policylableflag: ["0"],
+    classify: [],
+  };
+  return fetchApi("/industry", { method: "POST", body });
+}
+
+/** 获取事件列表。BASE_URL + /getevent，POST，请求体格式以实际接口为准 */
+async function getEventList() {
+  const body = {
+    times: "",
+    timee: "",
+    page: 1,
+    searchType: 1,
+    similar: 0,
+    matchingmode: 1,
+    emotionalIndex: [1, 2, 3],
+    province: [],
+    city: [],
+    eventIndex: [],
+    industryIndex: [],
+    searchword: "",
+    timeType: 4,
+    organizationtype: ["0"],
+    categorylabledata: ["0"],
+    enterprisetypelist: ["0"],
+    hightechtypelist: ["0"],
+    policylableflag: ["0"],
+    classify: [],
+  };
+  return fetchApi("/getevent", { method: "POST", body });
+}
+
+/** 将逗号分隔或数组转为数组，过滤空串 */
+function toList(val) {
+  if (val == null || val === "") return [];
+  if (Array.isArray(val)) return val.map(String).filter(Boolean);
+  return String(val).split(/[,，]/).map((s) => s.trim()).filter(Boolean);
+}
+
+async function searchYuqing(options) {
+  const {
+    keyword,
+    timeType = 5,
+    pageNum = 1,
+    pageSize = 20,
+    mergeType = 1,
+    sortType = 1,
+    matchType = 1,
+    emotionalIndex = [],
+    industryIndex = [],
+    eventIndex = [],
+    province = [],
+    city = [],
+    organization = [],
+    categorylable = [],
+    enterprisetype = [],
+    hightechtype = [],
+    policylableflag = [],
+  } = options;
+  const industry = toList(industryIndex);
+  const event = toList(eventIndex);
+  const prov = toList(province);
+  const cityList = toList(city);
+  const org = toList(organization);
+  const category = toList(categorylable);
+  const enterprise = toList(enterprisetype);
+  const hightech = toList(hightechtype);
+  const policy = toList(policylableflag);
+  const emotional = toList(emotionalIndex);
+
+  const params = new URLSearchParams();
+  params.set("searchWord", String(keyword));
+  params.set("timeType", String(timeType));
+  params.set("pageNum", String(pageNum));
+  params.set("pageSize", String(pageSize));
+  params.set("matchType", String(matchType >= 1 && matchType <= 3 ? matchType : 1));
+  params.set("sortType", String(sortType >= 1 && sortType <= 3 ? sortType : 1));
+  params.set("mergeType", String(mergeType === 1 ? 1 : 0));
+  emotional.forEach((v) => params.append("emotionalIndex", v));
+  industry.forEach((v) => params.append("industryIndex", v));
+  event.forEach((v) => params.append("eventIndex", v));
+  prov.forEach((v) => params.append("province", v));
+  cityList.forEach((v) => params.append("city", v));
+  org.forEach((v) => params.append("organization", v));
+  category.forEach((v) => params.append("categorylable", v));
+  enterprise.forEach((v) => params.append("enterprisetype", v));
+  hightech.forEach((v) => params.append("hightechtype", v));
+  policy.forEach((v) => params.append("policylableflag", v));
+
+  const url = `${BASE_URL}/fullsearch/informationList?${params}`;
+  try {
+    const res = await fetch(url, {
+      headers: {
+        "User-Agent":
+          "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+      },
+      signal: AbortSignal.timeout(30000),
+    });
+    const data = await res.json();
+    return data;
+  } catch (e) {
+    return { code: -1, message: e.message, data: null };
+  }
+}
+
+function formatEmotional(index) {
+  const m = { 1: "正面", 2: "中性", 3: "负面" };
+  return m[index] ?? "未知";
+}
+
+function stripHtml(html) {
+  if (typeof html !== "string") return "";
+  return html.replace(/<[^>]+>/g, "");
+}
+
+const server = new Server(
+  {
+    name: "yuqing-fullsearch",
+    version: "1.0.0",
+  },
+  {
+    capabilities: { tools: {} },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "yuqing_industry_list",
+        description: "获取国内舆情检索可用的行业列表，用于 fullsearch_information_list 的 industry_index 参数。无需入参。",
+        inputSchema: { type: "object", properties: {}, required: [] },
+      },
+      {
+        name: "yuqing_event_list",
+        description: "获取国内舆情检索可用的事件列表，用于 fullsearch_information_list 的 event_index 参数。无需入参。",
+        inputSchema: { type: "object", properties: {}, required: [] },
+      },
+      {
+        name: "fullsearch_information_list",
+        description:
+          "国内舆情检索,`keyword`中禁止涉及省份、城市内容。例如：`四川地震`，`四川`设置到`province`中，`地震`才作为`keyword`.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            keyword: {
+              type: "string",
+              description: "【必填】检索关键词，禁止使用city和province内容",
+            },
+            time_type: {
+              type: "integer",
+              default: 5,
+              description: "【必填】时间范围：1=24h,2=一年,3=昨天,4=3天,5=最近7天(常用),6=15天,7=30天,8=自定义",
+            },
+            page_num: {
+              type: "integer",
+              default: 1,
+              description: "【必填】页码，要更多结果时递增",
+            },
+            page_size: {
+              type: "integer",
+              default: 20,
+              description: "【必填】每页条数，可填 20 或 30",
+            },
+            merge_type: {
+              type: "integer",
+              default: 1,
+              description: "【必填】相似文章：0=取消合并，1=合并文章。按需选，默认1",
+            },
+            sort_type: {
+              type: "integer",
+              default: 1,
+              description: "【必填】信息排序：1=时间降序，2=时间升序，3=相似数倒序。按需选，默认1",
+            },
+            match_type: {
+              type: "integer",
+              default: 1,
+              description: "【必填】匹配方式：1=全文匹配，2=标题匹配，3=正文匹配。按需选，默认1",
+            },
+            emotional_index: {
+              type: "string",
+              description: "【必填】情感属性，多选用逗号分隔。1=正面，2=中性，3=负面。不传则不限情感；传如 1,2,3 则只查这些",
+            },
+            industry_index: {
+              type: "string",
+              description: "【必填】涉及行业，多选用逗号分隔。例：旅游行业,互联网,文化传媒。不需要筛选时不填",
+            },
+            event_index: {
+              type: "string",
+              description: "【必填】涉及事件，多选用逗号分隔。例：历史事件,突发事件,行业研究。不需要时不填",
+            },
+            province: {
+              type: "string",
+              description: "【必填】涉及省份，多选用逗号分隔。例：河南,北京,广东。不需要时不填",
+            },
+            city: {
+              type: "string",
+              description: "【必填】涉及城市，多选用逗号分隔。例：上海,北京,武汉。不需要时不填",
+            },
+            organization: {
+              type: "string",
+              description: "【必填】涉及机构，多选用逗号分隔。不需要时不填",
+            },
+            categorylable: {
+              type: "string",
+              description: "【必填】文章分类，多选用逗号分隔。不需要时不填",
+            },
+            enterprisetype: {
+              type: "string",
+              description: "【必填】涉及企业，多选用逗号分隔。不需要时不填",
+            },
+            hightechtype: {
+              type: "string",
+              description: "【必填】涉及高新企业，多选用逗号分隔。不需要时不填",
+            },
+            policylableflag: {
+              type: "string",
+              description: "【必填】涉及政策，多选用逗号分隔。不需要时不填",
+            },
+          },
+          required: ["keyword","time_type","page_num","page_size","merge_type","sort_type","match_type","emotional_index","industry_index","event_index","province","city","organization","categorylable","enterprisetype","hightechtype","policylableflag","keyword"],
+        },
+      },
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const toolName = request.params.name;
+
+  if (toolName === "yuqing_industry_list") {
+    const result = await getIndustryList();
+    const text =
+      result.code === 200
+        ? JSON.stringify(result, null, 2)
+        : JSON.stringify({ error: result.message || "请求失败", code: result.code }, null, 2);
+    return { content: [{ type: "text", text }] };
+  }
+
+  if (toolName === "yuqing_event_list") {
+    const result = await getEventList();
+    const text =
+      result.code === 200
+        ? JSON.stringify(result, null, 2)
+        : JSON.stringify({ error: result.message || "请求失败", code: result.code }, null, 2);
+    return { content: [{ type: "text", text }] };
+  }
+
+  if (toolName !== "fullsearch_information_list") {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: "Unknown tool: " + toolName,
+          }),
+        },
+      ],
+      isError: true,
+    };
+  }
+
+  const args = request.params.arguments ?? {};
+  const keyword = args.keyword ?? "";
+  const timeType = Number(args.time_type) || 5;
+  const pageNum = Number(args.page_num) || 1;
+  const pageSize = Number(args.page_size) || 20;
+  const mergeType = Number(args.merge_type) === 0 ? 0 : 1;
+  const sortType = Number(args.sort_type) || 1;
+  const matchType = Number(args.match_type) || 1;
+  const emotionalIndex = args.emotional_index;
+  const industryIndex = args.industry_index;
+  const eventIndex = args.event_index;
+  const province = args.province;
+  const city = args.city;
+  const organization = args.organization;
+  const categorylable = args.categorylable;
+  const enterprisetype = args.enterprisetype;
+  const hightechtype = args.hightechtype;
+  const policylableflag = args.policylableflag;
+
+  const result = await searchYuqing({
+    keyword,
+    timeType,
+    pageNum,
+    pageSize,
+    mergeType,
+    sortType,
+    matchType,
+    emotionalIndex,
+    industryIndex,
+    eventIndex,
+    province,
+    city,
+    organization,
+    categorylable,
+    enterprisetype,
+    hightechtype,
+    policylableflag,
+  });
+
+  if (result.code !== 200) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            { error: result.message || "请求失败", code: result.code },
+            null,
+            2
+          ),
+        },
+      ],
+    };
+  }
+
+  const data = result.data || {};
+  const items = data.data || [];
+  const out = items.map((item, i) => ({
+    序号: i + 1,
+    标题: item.title ?? "",
+    来源: item.source_name ?? "",
+    日期: item.publish_time ?? "",
+    情感: formatEmotional(item.emotionalIndex),
+    URL: item.source_url ?? "",
+    内容摘要:
+      stripHtml(item.content ?? "").slice(0, 500) +
+      (stripHtml(item.content ?? "").length > 500 ? "..." : ""),
+  }));
+
+  const text = JSON.stringify(
+    { keyword, total: out.length, items: out },
+    null,
+    2
+  );
+
+  return {
+    content: [{ type: "text", text }],
+  };
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);