Xueqiu MCP

Instructions

Args:
    index_code: 指数代码

Implementation Reference

• main.py:343-351 (handler)

  The primary handler function for the MCP tool 'index_perf_7'. It is registered via the @mcp.tool() decorator, fetches 7-day index performance data from pysnowball (ball.index_perf_7), processes timestamps, and returns the result as a dict. Includes input schema via type hints and docstring.

  @mcp.tool()
  def index_perf_7(index_code: str="SZ000002") -> dict:
      """获取指数最近7天收益数据
      
      Args:
          index_code: 指数代码
      """
      result = ball.index_perf_7(index_code)
      return process_data(result)

• main.py:34-61 (helper)

  Supporting helper function called by index_perf_7 to process the raw data, primarily converting Unix timestamps to human-readable datetime strings.

  def process_data(data, process_config=None):
      """
      通用数据处理函数，可扩展添加各种数据处理操作
      
      Args:
          data: 原始数据
          process_config: 处理配置字典，用于指定要执行的处理操作
              例如: {'convert_timestamps': True, 'other_process': params}
      
      Returns:
          处理后的数据
      """
      if process_config is None:
          # 默认配置
          process_config = {
              'convert_timestamps': True
          }
      
      # 如果开启了时间戳转换
      if process_config.get('convert_timestamps', True):
          data = convert_timestamps(data)
      
      # 在这里可以添加更多的数据处理逻辑
      # 例如:
      # if 'format_numbers' in process_config:
      #     data = format_numbers(data, **process_config['format_numbers'])
      
      return data

• main.py:14-31 (helper)

  Recursive utility helper to convert timestamp fields (including _date suffixes) in nested data structures to formatted datetime strings, invoked by process_data.

  def convert_timestamps(data):
      """递归地将数据中的所有 timestamp 转换为 datetime 字符串"""
      if isinstance(data, dict):
          for key, value in list(data.items()):
              if key == 'timestamp' and isinstance(value, (int, float)) and value > 1000000000000:  # 毫秒级时间戳
                  data[key] = datetime.datetime.fromtimestamp(value/1000).strftime('%Y-%m-%d %H:%M:%S')
              elif key == 'timestamp' and isinstance(value, (int, float)) and value > 1000000000:  # 秒级时间戳
                  data[key] = datetime.datetime.fromtimestamp(value).strftime('%Y-%m-%d %H:%M:%S')
              elif key.endswith('_date') and isinstance(value, (int, float)) and value > 1000000000000:  # 毫秒级时间戳
                  data[key] = datetime.datetime.fromtimestamp(value/1000).strftime('%Y-%m-%d %H:%M:%S')
              elif key.endswith('_date') and isinstance(value, (int, float)) and value > 1000000000:  # 秒级时间戳
                  data[key] = datetime.datetime.fromtimestamp(value).strftime('%Y-%m-%d %H:%M:%S')
              elif isinstance(value, (dict, list)):
                  data[key] = convert_timestamps(value)
      elif isinstance(data, list):
          for i, item in enumerate(data):
              data[i] = convert_timestamps(item)
      return data