index_data
Retrieve historical data for specific stock indices, such as the Shanghai or Shenzhen Index, using the MCP protocol. Input index code and date range to access financial data.
Instructions
获取指定股票指数的数据，例如上证指数、深证成指等
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | 指数代码，如'000001.SH'表示上证指数，'399001.SZ'表示深证成指 | |
| end_date | Yes | 结束日期，格式为YYYYMMDD，如'20230131' | |
| start_date | Yes | 起始日期，格式为YYYYMMDD，如'20230101' |
Implementation Reference
- build/tools/indexData.js:2-132 (handler)Full implementation of the 'index_data' tool including name, description, input schema, and the async run handler that fetches index data from Tushare API, processes it, analyzes trend, and formats output.
export const indexData = { name: "index_data", description: "获取指定股票指数的数据，例如上证指数、深证成指等", parameters: { type: "object", properties: { code: { type: "string", description: "指数代码，如'000001.SH'表示上证指数，'399001.SZ'表示深证成指" }, start_date: { type: "string", description: "起始日期，格式为YYYYMMDD，如'20230101'" }, end_date: { type: "string", description: "结束日期，格式为YYYYMMDD，如'20230131'" } }, required: ["code", "start_date", "end_date"] }, async run(args) { try { console.log(`使用Tushare API获取指数${args.code}的数据`); // 使用全局配置中的Tushare API设置 const TUSHARE_API_KEY = TUSHARE_CONFIG.API_TOKEN; const TUSHARE_API_URL = TUSHARE_CONFIG.API_URL; // 默认参数设置 const today = new Date(); const defaultEndDate = today.toISOString().slice(0, 10).replace(/-/g, ''); const oneMonthAgo = new Date(); oneMonthAgo.setMonth(oneMonthAgo.getMonth() - 1); const defaultStartDate = oneMonthAgo.toISOString().slice(0, 10).replace(/-/g, ''); // 构建请求参数 const params = { api_name: "index_daily", token: TUSHARE_API_KEY, params: { ts_code: args.code, start_date: args.start_date || defaultStartDate, end_date: args.end_date || defaultEndDate }, fields: "ts_code,trade_date,open,high,low,close,pre_close,change,pct_chg,vol,amount" }; // 设置请求超时 const controller = new AbortController(); const timeoutId = setTimeout(() => controller.abort(), TUSHARE_CONFIG.TIMEOUT); try { console.log(`请求Tushare API: ${params.api_name}，参数:`, params.params); // 发送请求 const response = await fetch(TUSHARE_API_URL, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(params), signal: controller.signal }); if (!response.ok) { throw new Error(`Tushare API请求失败: ${response.status}`); } const data = await response.json(); // 处理响应数据 if (data.code !== 0) { throw new Error(`Tushare API错误: ${data.msg}`); } // 确保data.data和data.data.items存在 if (!data.data || !data.data.items || data.data.items.length === 0) { throw new Error(`未找到指数${args.code}的数据`); } // 获取字段名 const fields = data.data.fields; // 将数据转换为对象数组 const indexData = data.data.items.map((item) => { const result = {}; fields.forEach((field, index) => { result[field] = item[index]; }); return result; }); // 收集涨跌数据用于生成趋势分析 const closePrices = indexData.map((item) => parseFloat(item.close)); let trend = "持平"; let trendAnalysis = ""; if (closePrices.length > 1) { const firstPrice = closePrices[closePrices.length - 1]; // 最早的收盘价 const lastPrice = closePrices[0]; // 最近的收盘价 const change = ((lastPrice - firstPrice) / firstPrice * 100).toFixed(2); if (lastPrice > firstPrice) { trend = `上涨 ${change}%`; trendAnalysis = `在此期间，${args.code}整体呈上涨趋势，累计涨幅达${change}%。`; } else if (lastPrice < firstPrice) { trend = `下跌 ${Math.abs(parseFloat(change))}%`; trendAnalysis = `在此期间，${args.code}整体呈下跌趋势，累计跌幅达${Math.abs(parseFloat(change))}%。`; } } // 格式化输出日期范围 const startDate = indexData[indexData.length - 1]?.trade_date || args.start_date || defaultStartDate; const endDate = indexData[0]?.trade_date || args.end_date || defaultEndDate; // 格式化输出 const formattedData = indexData.map((data) => { return `## ${data.trade_date}\n开盘: ${data.open} 最高: ${data.high} 最低: ${data.low} 收盘: ${data.close}\n涨跌: ${data.change} 涨跌幅: ${data.pct_chg}% 成交量: ${data.vol} 成交额: ${data.amount}\n`; }).join('\n---\n\n'); return { content: [ { type: "text", text: `# ${args.code}指数数据 (${startDate} 至 ${endDate})\n\n` + `## 期间走势: ${trend}\n${trendAnalysis}\n\n---\n\n${formattedData}` } ] }; } finally { clearTimeout(timeoutId); } } catch (error) { console.error("获取指数数据失败:", error); return { content: [ { type: "text", text: `# 获取指数${args.code}数据失败\n\n无法从Tushare API获取数据：${error instanceof Error ? error.message : String(error)}\n\n请检查指数代码是否正确，常用指数代码：\n- 上证指数: 000001.SH\n- 深证成指: 399001.SZ\n- 创业板指: 399006.SZ\n- 沪深300: 000300.SH\n- 中证500: 000905.SH` } ] }; } } }; - build/tools/indexData.js:5-22 (schema)Input schema definition for the index_data tool specifying required parameters: code, start_date, end_date.
parameters: { type: "object", properties: { code: { type: "string", description: "指数代码，如'000001.SH'表示上证指数，'399001.SZ'表示深证成指" }, start_date: { type: "string", description: "起始日期，格式为YYYYMMDD，如'20230101'" }, end_date: { type: "string", description: "结束日期，格式为YYYYMMDD，如'20230131'" } }, required: ["code", "start_date", "end_date"] }, - build/index.js:228-232 (registration)Registration and call handler for index_data tool in the MCP stdio server switch statement.
case "index_data": { const code = String(request.params.arguments?.code); const start_date = request.params.arguments?.start_date ? String(request.params.arguments.start_date) : undefined; const end_date = request.params.arguments?.end_date ? String(request.params.arguments.end_date) : undefined; return await indexData.run({ code, start_date, end_date }); - build/index.js:129-131 (registration)Tool listing registration in ListToolsRequestSchema handler for MCP stdio server.
name: indexData.name, description: indexData.description, inputSchema: indexData.parameters - build/httpServer.js:243-248 (registration)Tool call handler registration for index_data in the HTTP server MCP tools/call endpoint.
case 'index_data': return await indexData.run({ code: String(args?.code), start_date: args?.start_date ? String(args.start_date) : undefined, end_date: args?.end_date ? String(args.end_date) : undefined, });