linker-wind-mcp 0.1.0

package/README.md

@@ -0,0 +1,250 @@
+# linker-wind-mcp
+
+MCP server for Wind 金融数据终端，提供 6 个 Wind API 工具。
+
+## 功能
+
+| 工具 | Wind API | 格式 | 用途 |
+|------|----------|------|------|
+| `get_wind_daily` | w.wsd() | TSV | 日频历史数据（开/高/低/收/量/仓） |
+| `get_wind_minutes` | w.wsi() | TSV | 分钟级K线（1/5/15/30/60分钟） |
+| `get_wind_realtime` | w.wsq() | JSON | 实时行情快照（最新价/买卖盘/成交量） |
+| `get_wind_cross_section` | w.wss() | TSV | 横截面批量数据（多合约同一时点） |
+| `get_wind_sector` | w.wset() | JSON | 板块成分列表（交易所合约/指数） |
+| `get_wind_edb` | w.edb() | TSV | 宏观/产业经济指标时间序列 |
+
+## 安装
+
+```bash
+npm install
+npm run build
+```
+
+## 配置
+
+### Claude Desktop
+
+编辑 `claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "linker-wind": {
+      "command": "npx",
+      "args": ["-y", "linker-wind-mcp"],
+      "env": {
+        "WIND_API_BASE": "http://api_ai.linker.net/wind-api"
+      }
+    }
+  }
+}
+```
+
+**本地调试**：将 `WIND_API_BASE` 改为 `http://192.168.10.200:10010`
+
+### Cursor
+
+编辑项目根目录 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "linker-wind": {
+      "command": "npx",
+      "args": ["-y", "linker-wind-mcp"],
+      "env": {
+        "WIND_API_BASE": "http://192.168.10.200:10010"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+在项目根目录创建 `.mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "linker-wind": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "linker-wind-mcp"],
+      "env": {
+        "WIND_API_BASE": "http://192.168.10.200:10010"
+      }
+    }
+  }
+}
+```
+
+或使用命令行：
+
+```bash
+claude mcp add linker-wind --env WIND_API_BASE=http://192.168.10.200:10010 -- npx -y linker-wind-mcp
+```
+
+## 使用示例
+
+### 1. 日频行情（wsd）
+
+**单合约多字段**：
+```
+用户: PG2609.DCE 最近5天的开高低收量仓
+AI调用: get_wind_daily({
+  codes: ["PG2609.DCE"],
+  fields: ["open","high","low","close","volume","oi"],
+  start_date: "2026-07-14",
+  end_date: "2026-07-18"
+})
+```
+
+**多合约单字段**：
+```
+用户: 对比 PG2609、PG2611、PG2701 三个合约的收盘价
+AI调用: get_wind_daily({
+  codes: ["PG2609.DCE","PG2611.DCE","PG2701.DCE"],
+  fields: ["close"],
+  start_date: "2026-07-14",
+  end_date: "2026-07-18"
+})
+```
+
+### 2. 分钟行情（wsi）
+
+```
+用户: PG2609 今天上午9点到10点的5分钟K线
+AI调用: get_wind_minutes({
+  codes: ["PG2609.DCE"],
+  fields: ["open","high","low","close","volume"],
+  start_time: "2026-07-17 09:00:00",
+  end_time: "2026-07-17 10:00:00",
+  options: "BarSize=5"
+})
+```
+
+### 3. 实时行情（wsq）
+
+```
+用户: PG2609、M2509、PP2509 现在的价格和成交量
+AI调用: get_wind_realtime({
+  codes: ["PG2609.DCE","M2509.DCE","PP2509.DCE"]
+})
+```
+
+返回 JSON，默认字段：`rt_last`（最新价）、`rt_bid1`（买一）、`rt_ask1`（卖一）、`rt_vol`（成交量）
+
+### 4. 横截面数据（wss）
+
+```
+用户: 今天所有 PG 合约的收盘价和持仓量
+AI调用: get_wind_cross_section({
+  codes: ["PG2609.DCE","PG2611.DCE","PG2701.DCE"],
+  fields: ["close","oi"],
+  options: "tradeDate=2026-07-17"
+})
+```
+
+### 5. 板块成分（wset）
+
+```
+用户: PG（液化石油气）有哪些期货合约
+AI调用: get_wind_sector({
+  set_name: "futurecc",
+  options: "wind_code=PG.DCE;date=2026-07-17"
+})
+```
+
+> `futurecc` 用**品种代码**（如 `PG.DCE`、`CU.SHF`）而非交易所名。查指数成分用 `sectorconstituent` + `windcode=000300.SH`。
+
+### 6. 经济指标（edb）
+
+```
+用户: 查询 M0067855 指标最近一周的数据
+AI调用: get_wind_edb({
+  codes: ["M0067855"],
+  start_date: "2026-07-14",
+  end_date: "2026-07-18"
+})
+```
+
+## 测试
+
+### 方法一：直接测试 API 逻辑
+
+```bash
+node test_tool.mjs
+```
+
+### 方法二：curl 测后端
+
+```bash
+curl -X POST http://192.168.10.200:10010/execute \
+  -H "Content-Type: application/json" \
+  -d '{"code":"w.wsd(\"PG2609.DCE\", \"close\", \"2026-07-14\", \"2026-07-18\")","timeout":30}'
+```
+
+### 方法三：MCP stdio 协议测试
+
+参考 `testing.md` 中的 JSON-RPC 测试脚本。
+
+## 实测结果
+
+| 测试项 | 结果 |
+|-------|------|
+| wsd 单合约多字段 | ✅ 6字段4天数据 |
+| wsd 多合约单字段 | ✅ 3合约4天收盘价（M2509/PP2509全null - 非交易日） |
+| wsi 5分钟K线 | ✅ 12条5分钟数据 |
+| wsq 实时行情 | ✅ 3合约实时报价（bid/ask为0 - 非交易时段） |
+| wss 横截面 | ✅ 3合约收盘价+持仓量 |
+| MCP stdio 端到端 | ✅ readOnlyHint标注生效，TSV/JSON格式正确 |
+
+## 已知限制
+
+| 限制 | 说明 |
+|------|------|
+| **多合约+多字段** | Wind 不支持同时多合约多字段（error_code=-40522018），单次只能"单合约多字段"或"多合约单字段" |
+| **精度** | 数值保留2位小数（遵循规范），汇率等高精度数据会从 6.7779 截为 6.78 |
+| **非交易时段** | wsq 实时行情在非交易时段返回上一交易日收盘数据，bid/ask 为 0 |
+| **到期合约** | 已到期合约查询返回全 null，TSV 会跳过整行（null行不输出） |
+| **无鉴权** | Wind API 当前无认证机制，依赖网络隔离保障安全 |
+
+## 数据格式
+
+### TSV（时间序列）
+
+```
+# wsd | PG2609.DCE | close,volume | 2026-07-14~2026-07-18
+date	CLOSE	VOLUME
+2026-07-14	5031	10825
+2026-07-15	5060	6325
+2026-07-16	5061	7945
+2026-07-17	5102	8136
+```
+
+- 首行 `#` 元信息供 LLM 引用
+- 列名行仅一次
+- 数值 2 位小数
+- null 行跳过
+
+### JSON（快照/变结构）
+
+```json
+[
+  {"contract":"PG2609.DCE","rt_last":5558,"rt_bid1":5556,"rt_ask1":5559,"rt_vol":15329}
+]
+```
+
+用于 wsq 实时快照和 wset 板块成分（字段不固定）。
+
+## 开发
+
+```bash
+npm run build    # 编译
+npm run watch    # 监听模式
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,339 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const BASE = (process.env.WIND_API_BASE ?? "").replace(/\/$/, "");
+if (!BASE) {
+    process.stderr.write("WIND_API_BASE is required\n");
+    process.exit(1);
+}
+try {
+    new URL(BASE);
+}
+catch {
+    process.stderr.write(`WIND_API_BASE 格式无效: "${BASE}"，必须是合法的 http/https URL\n`);
+    process.exit(1);
+}
+async function windExecute(code, timeout = 30) {
+    let res;
+    try {
+        res = await fetch(`${BASE}/execute`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ code, timeout }),
+            signal: AbortSignal.timeout((timeout + 5) * 1000),
+        });
+    }
+    catch (e) {
+        if (e instanceof Error && e.name === "TimeoutError")
+            throw new Error(`Wind服务响应超时（>${timeout + 5}秒），请检查服务是否可用或缩小查询范围`);
+        throw e;
+    }
+    if (!res.ok)
+        throw new Error(`Wind服务返回 ${res.status}`);
+    try {
+        return (await res.json());
+    }
+    catch {
+        throw new Error(`Wind服务返回了非JSON响应（可能是网关错误或服务异常），HTTP ${res.status}`);
+    }
+}
+function text(data) {
+    return { content: [{ type: "text", text: typeof data === "string" ? data : JSON.stringify(data) }] };
+}
+function errText(msg) {
+    return { content: [{ type: "text", text: msg }], isError: true };
+}
+function fmt(v) {
+    if (v == null)
+        return null;
+    const n = Number(v);
+    if (isNaN(n))
+        return null;
+    return Number.isInteger(n) ? n : parseFloat(n.toFixed(2));
+}
+// 单元格格式化：数值走 fmt，非数值（合约名、状态等文本）原样保留，避免静默丢失
+function fmtCell(v) {
+    if (v == null)
+        return "";
+    const f = fmt(v);
+    return f != null ? String(f) : String(v);
+}
+// 转义拼入 Wind 代码串的字符串，防止引号破坏语法或注入
+function esc(s) {
+    return s.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/"/g, '\\"');
+}
+// 日期格式校验 YYYY-MM-DD
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+// 日期时间格式校验 YYYY-MM-DD HH:MM:SS
+const DATETIME_RE = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/;
+function validateDate(v, label) {
+    if (!DATE_RE.test(v))
+        return `${label} 格式错误："${v}"，需要 YYYY-MM-DD 格式`;
+    return null;
+}
+function validateDatetime(v, label) {
+    if (!DATETIME_RE.test(v))
+        return `${label} 格式错误："${v}"，需要 YYYY-MM-DD HH:MM:SS 格式`;
+    return null;
+}
+// 每 step 行取最后一行做降采样（收盘价语义取周期末值）
+function downsample(times, data, colCount, step) {
+    const outTimes = [];
+    const outData = Array.from({ length: colCount }, () => []);
+    for (let i = step - 1; i < times.length; i += step) {
+        outTimes.push(times[i]);
+        for (let ci = 0; ci < colCount; ci++) {
+            outData[ci].push(data[ci]?.[i] ?? null);
+        }
+    }
+    return { times: outTimes, data: outData };
+}
+const TSV_LIMIT = 200;
+// 将 WindResponse 的 times+codes+fields+data 转为 TSV
+// data 实际结构：二维数组 data[i][t]
+// 单合约多字段：i = field 索引，列头用 fields
+// 多合约单字段：i = code 索引，列头用 codes
+function toTsv(res, meta) {
+    let times = res.times ?? [];
+    const codes = res.codes ?? [];
+    const fields = res.fields ?? [];
+    let data = res.data;
+    if (!data || !times.length)
+        return `# ${meta}\n暂无数据`;
+    // 列标签：多合约时用 code，否则用 field
+    const colLabels = codes.length > 1 ? codes : fields;
+    let sampledNote = "";
+    // 超200点自动降采样（规范要求）；step 动态计算确保输出不超过 TSV_LIMIT
+    if (times.length > TSV_LIMIT) {
+        const orig = times.length;
+        const step = Math.ceil(orig / TSV_LIMIT);
+        const ds = downsample(times, data, colLabels.length, step);
+        times = ds.times;
+        data = ds.data;
+        sampledNote = ` [已降采样 ${orig}点→${times.length}点，建议改用 period=W 或 period=M]`;
+    }
+    const lines = [`# ${meta}${sampledNote}`, `date\t${colLabels.join("\t")}`];
+    for (let ti = 0; ti < times.length; ti++) {
+        const row = [times[ti]];
+        let allNull = true;
+        for (let i = 0; i < colLabels.length; i++) {
+            const cell = fmtCell(data[i]?.[ti]);
+            if (cell !== "")
+                allNull = false;
+            row.push(cell);
+        }
+        if (!allNull)
+            lines.push(row.join("\t"));
+    }
+    return lines.join("\n");
+}
+// ── MCP Server ────────────────────────────────────────────────────────────────
+const server = new McpServer({ name: "linker-wind-mcp", version: "0.1.0" });
+// 1. get_wind_daily — 日频历史数据 (w.wsd)
+server.tool("get_wind_daily", "查询期货/股票/指数的Wind历史数据（w.wsd），支持日/周/月频率。注意：多合约只能查单字段，单合约可查多字段。返回TSV格式时间序列。超过200点自动降采样并提示。适合'某合约历史价格'、'近一个月涨跌幅'、'一年周频数据'等场景。", {
+    codes: z.array(z.string()).describe("合约/证券代码列表，如 [\"PG2606.DCE\", \"M2509.DCE\"]"),
+    fields: z.array(z.string()).describe("字段列表，如 [\"close\",\"volume\",\"oi\"]，常用：close=收盘价 open=开盘价 high=最高 low=最低 volume=成交量 oi=持仓量"),
+    start_date: z.string().describe("开始日期 YYYY-MM-DD"),
+    end_date: z.string().describe("结束日期 YYYY-MM-DD"),
+    period: z.enum(["D", "W", "M"]).optional().describe("频率：D=日（默认）, W=周, M=月。查询超过3个月建议用W，超过1年建议用M"),
+    options: z.string().optional().describe("Wind附加参数，如 \"PriceAdj=F\" 表示前复权，period参数已覆盖频率设置"),
+}, { readOnlyHint: true }, async ({ codes, fields, start_date, end_date, period, options }) => {
+    if (!codes.length)
+        return errText("codes 不能为空");
+    if (!fields.length)
+        return errText("fields 不能为空");
+    const dateErr = validateDate(start_date, "start_date") ?? validateDate(end_date, "end_date");
+    if (dateErr)
+        return errText(dateErr);
+    if (codes.length > 1 && fields.length > 1)
+        return errText("Wind 不支持同时多合约+多字段（error_code=-40522018），请改为单合约多字段或多合约单字段");
+    const codesStr = esc(codes.join(","));
+    const fieldsStr = esc(fields.join(","));
+    const periodOpt = period && period !== "D" ? `Period=${period}` : null;
+    const allOpts = [periodOpt, options].filter(Boolean).join(";");
+    const opts = allOpts ? `, "${esc(allOpts)}"` : "";
+    const code = `w.wsd('${codesStr}', '${fieldsStr}', '${esc(start_date)}', '${esc(end_date)}'${opts})`;
+    try {
+        const res = await windExecute(code);
+        if (!res.success)
+            return errText(`Wind查询失败: ${res.error ?? `error_code=${res.error_code}`}`);
+        const meta = `wsd | ${codesStr} | ${fieldsStr} | ${start_date}~${end_date}${period ? ` | period=${period}` : ""}`;
+        return text(toTsv(res, meta));
+    }
+    catch (e) {
+        return errText(`请求Wind服务失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// 2. get_wind_minutes — 分钟级数据 (w.wsi)
+server.tool("get_wind_minutes", "查询期货合约的Wind分钟级行情数据（w.wsi），支持1/5/15/30/60分钟频率。返回TSV格式时间序列。适合'今日盘中走势'、'某时间段分钟行情'等场景。", {
+    codes: z.array(z.string()).describe("合约代码列表，如 [\"PG2606.DCE\"]"),
+    fields: z.array(z.string()).describe("字段列表，如 [\"close\",\"volume\"]"),
+    start_time: z.string().describe("开始时间 YYYY-MM-DD HH:MM:SS"),
+    end_time: z.string().describe("结束时间 YYYY-MM-DD HH:MM:SS"),
+    bar_size: z.enum(["1", "5", "15", "30", "60"]).optional().describe("K线周期（分钟）：1/5/15/30/60，默认1分钟"),
+    options: z.string().optional().describe("Wind附加参数，bar_size已覆盖BarSize设置"),
+}, { readOnlyHint: true }, async ({ codes, fields, start_time, end_time, bar_size, options }) => {
+    if (!codes.length)
+        return errText("codes 不能为空");
+    if (!fields.length)
+        return errText("fields 不能为空");
+    const dtErr = validateDatetime(start_time, "start_time") ?? validateDatetime(end_time, "end_time");
+    if (dtErr)
+        return errText(dtErr);
+    const codesStr = esc(codes.join(","));
+    const fieldsStr = esc(fields.join(","));
+    const barOpt = bar_size && bar_size !== "1" ? `BarSize=${bar_size}` : null;
+    const allOpts = [barOpt, options].filter(Boolean).join(";");
+    const opts = allOpts ? `, "${esc(allOpts)}"` : "";
+    const code = `w.wsi('${codesStr}', '${fieldsStr}', '${esc(start_time)}', '${esc(end_time)}'${opts})`;
+    try {
+        const res = await windExecute(code);
+        if (!res.success)
+            return errText(`Wind查询失败: ${res.error ?? `error_code=${res.error_code}`}`);
+        const meta = `wsi | ${codesStr} | ${fieldsStr} | ${start_time}~${end_time}${bar_size ? ` | bar=${bar_size}m` : ""}`;
+        return text(toTsv(res, meta));
+    }
+    catch (e) {
+        return errText(`请求Wind服务失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// 3. get_wind_realtime — 实时行情快照 (w.wsq)
+server.tool("get_wind_realtime", "查询期货/股票合约的Wind实时行情快照（w.wsq），含最新价、买卖价、成交量等。适合'某合约现价'、'多个合约实时报价对比'等场景。", {
+    codes: z.array(z.string()).describe("合约代码列表，如 [\"PG2606.DCE\", \"M2509.DCE\"]"),
+    fields: z.array(z.string()).optional().describe("字段列表，留空默认查 [\"rt_last\",\"rt_bid1\",\"rt_ask1\",\"rt_vol\"]，rt_last=最新价 rt_bid1=买一 rt_ask1=卖一 rt_vol=成交量"),
+}, { readOnlyHint: true }, async ({ codes, fields }) => {
+    if (!codes.length)
+        return errText("codes 不能为空");
+    const codesStr = esc(codes.join(","));
+    const fieldsStr = esc((fields ?? ["rt_last", "rt_bid1", "rt_ask1", "rt_vol"]).join(","));
+    const code = `w.wsq('${codesStr}', '${fieldsStr}')`;
+    try {
+        const res = await windExecute(code);
+        if (!res.success)
+            return errText(`Wind查询失败: ${res.error ?? `error_code=${res.error_code}`}`);
+        const resCodes = res.codes ?? codes;
+        const resFields = res.fields ?? [];
+        const data = res.data;
+        if (!data)
+            return text("暂无实时行情数据");
+        // wsq: data[fi] = 第 fi 个字段在所有合约上的值数组，data[fi][ci] = 第 fi 字段第 ci 个合约的值
+        // 外层遍历合约（ci），内层遍历字段（fi），与 wss 的 data[fi][ci] 结构一致
+        const result = resCodes.map((c, ci) => {
+            const row = { contract: c };
+            for (let fi = 0; fi < resFields.length; fi++) {
+                const val = data[fi]?.[ci] ?? null;
+                row[resFields[fi].toLowerCase()] = fmt(val) ?? val;
+            }
+            return row;
+        });
+        return text(result);
+    }
+    catch (e) {
+        return errText(`请求Wind服务失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// 4. get_wind_cross_section — 横截面数据 (w.wss)
+server.tool("get_wind_cross_section", "查询多个合约在同一时点的横截面数据（w.wss），适合批量获取某日的基本面、财务或行情字段。返回TSV格式。适合'某日全市场持仓量排名'、'批量查合约基本信息'等场景。", {
+    codes: z.array(z.string()).describe("合约/证券代码列表，如 [\"PG2609.DCE\", \"PG2611.DCE\"]"),
+    fields: z.array(z.string()).describe("字段列表，如 [\"close\",\"oi\",\"contractmultiplier\"]"),
+    options: z.string().optional().describe("Wind附加参数，如 \"tradeDate=2026-07-18\" 指定查询日期"),
+}, { readOnlyHint: true }, async ({ codes, fields, options }) => {
+    if (!codes.length)
+        return errText("codes 不能为空");
+    if (!fields.length)
+        return errText("fields 不能为空");
+    const codesStr = esc(codes.join(","));
+    const fieldsStr = esc(fields.join(","));
+    const opts = options ? `, "${esc(options)}"` : "";
+    const code = `w.wss('${codesStr}', '${fieldsStr}'${opts})`;
+    try {
+        const res = await windExecute(code);
+        if (!res.success)
+            return errText(`Wind查询失败: ${res.error ?? `error_code=${res.error_code}`}`);
+        const resCodes = res.codes ?? codes;
+        const resFields = res.fields ?? fields;
+        const data = res.data;
+        if (!data)
+            return text("暂无横截面数据");
+        // wss: data[fi][ci] = 第 fi 个 field，第 ci 个 code 的值
+        const lines = [`# wss | ${codesStr} | ${fieldsStr}${options ? ` | ${options}` : ""}`, `code\t${resFields.join("\t")}`];
+        for (let ci = 0; ci < resCodes.length; ci++) {
+            const row = [resCodes[ci]];
+            let allNull = true;
+            for (let fi = 0; fi < resFields.length; fi++) {
+                const cell = fmtCell(data[fi]?.[ci]);
+                if (cell !== "")
+                    allNull = false;
+                row.push(cell);
+            }
+            if (!allNull)
+                lines.push(row.join("\t"));
+        }
+        return text(lines.join("\n"));
+    }
+    catch (e) {
+        return errText(`请求Wind服务失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// 5. get_wind_sector — 板块成分 (w.wset)
+server.tool("get_wind_sector", "查询Wind板块成分列表（w.wset），如某品种所有期货合约、某指数成分股等。适合'PG有哪些合约'、'铜期货合约列表'等场景。", {
+    set_name: z.string().describe("板块名称，如 \"futurecc\" 表示期货合约列表，\"sectorconstituent\" 表示指数成分"),
+    options: z.string().optional().describe("Wind附加参数。futurecc用 \"wind_code=PG.DCE\" 查PG所有合约，\"wind_code=CU.SHF\" 查铜；sectorconstituent用 \"date=2026-07-17;windcode=000300.SH\" 查沪深300成分"),
+}, { readOnlyHint: true }, async ({ set_name, options }) => {
+    const opts = options ? `, "${esc(options)}"` : "";
+    const code = `w.wset('${esc(set_name)}'${opts})`;
+    try {
+        const res = await windExecute(code);
+        if (!res.success)
+            return errText(`Wind查询失败: ${res.error ?? `error_code=${res.error_code}`}`);
+        const fields = res.fields ?? [];
+        const data = res.data;
+        if (!data || !fields.length)
+            return text("暂无板块数据");
+        // wset: data[fi] = 第 fi 个字段的所有行值，codes = 行序号
+        const rowCount = data[0]?.length ?? 0;
+        if (!rowCount)
+            return text("暂无板块数据");
+        const meta = `# wset | ${set_name}${options ? ` | ${options}` : ""} | ${rowCount}条`;
+        const lines = [meta, fields.join("\t")];
+        for (let ri = 0; ri < rowCount; ri++) {
+            const row = fields.map((_f, fi) => fmtCell(data[fi]?.[ri]));
+            lines.push(row.join("\t"));
+        }
+        return text(lines.join("\n"));
+    }
+    catch (e) {
+        return errText(`请求Wind服务失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// 6. get_wind_edb — 经济数据库 (w.edb)
+server.tool("get_wind_edb", "查询Wind经济数据库（w.edb）的宏观/产业时间序列数据，支持化工、能源、汇率、原油等品类指标。返回TSV格式。适合'丁二烯近一个月价格'、'布伦特原油历史数据'、'某宏观指标走势'等场景。", {
+    codes: z.array(z.string()).describe("EDB指标代码列表，如 [\"M0067855\",\"S0059742\"]，代码可从Wind终端「数据浏览器」查询获取"),
+    start_date: z.string().describe("开始日期 YYYY-MM-DD"),
+    end_date: z.string().describe("结束日期 YYYY-MM-DD"),
+    options: z.string().optional().describe("Wind附加参数，如 \"Period=M\" 表示月频"),
+}, { readOnlyHint: true }, async ({ codes, start_date, end_date, options }) => {
+    if (!codes.length)
+        return errText("codes 不能为空");
+    const dateErr = validateDate(start_date, "start_date") ?? validateDate(end_date, "end_date");
+    if (dateErr)
+        return errText(dateErr);
+    const codesStr = esc(codes.join(","));
+    const opts = options ? `, "${esc(options)}"` : "";
+    const code = `w.edb('${codesStr}', '${esc(start_date)}', '${esc(end_date)}'${opts})`;
+    try {
+        const res = await windExecute(code);
+        if (!res.success)
+            return errText(`Wind查询失败: ${res.error ?? `error_code=${res.error_code}`}`);
+        const meta = `edb | ${codesStr} | ${start_date}~${end_date}`;
+        return text(toTsv(res, meta));
+    }
+    catch (e) {
+        return errText(`请求Wind服务失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// ── start ─────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("linker-wind-mcp 已启动, WIND_API_BASE=" + BASE);

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "linker-wind-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Wind financial data (wsd/wsi/wsq/wss/wset/edb)",
+  "type": "module",
+  "bin": {
+    "linker-wind-mcp": "dist/index.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "shx": "^0.3.4",
+    "typescript": "^5.8.2"
+  },
+  "engines": { "node": ">=18" },
+  "license": "MIT"
+}