Xueqiu MCP

Instructions

Args:
    cube_symbol: 组合代码

Implementation Reference

• main.py:276-284 (handler)

  The main handler function for the 'nav_daily' tool. It is registered via the @mcp.tool() decorator and implements the tool logic by fetching data from the pysnowball library (ball.nav_daily) and processing it with process_data.

  @mcp.tool()
  def nav_daily(cube_symbol: str="SZ000002") -> dict:
      """获取组合净值数据
      
      Args:
          cube_symbol: 组合代码
      """
      result = ball.nav_daily(cube_symbol)
      return process_data(result)

• main.py:34-62 (helper)

  Shared helper function called by the nav_daily handler (and all other tools) to process the raw data returned from the library, primarily converting 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-32 (helper)

  Supporting utility function used by process_data to recursively convert timestamp fields in the data to formatted datetime strings.

  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

• main.py:276-276 (registration)

  The @mcp.tool() decorator registers the nav_daily function as an MCP tool.

  @mcp.tool()