Xueqiu MCP

Instructions

Implementation Reference

• main.py:258-262 (handler)

  The handler function for the 'watch_list' tool. It retrieves the user's watch list using the pysnowball library (ball.watch_list()) and processes the data to convert timestamps to readable datetime strings.

  @mcp.tool()
  def watch_list() -> dict:
      """获取用户自选列表"""
      result = ball.watch_list()
      return process_data(result)

• main.py:258-258 (registration)

  The @mcp.tool() decorator registers the watch_list function as an MCP tool with the name 'watch_list'.

  @mcp.tool()

• main.py:34-62 (helper)

  Helper function used by watch_list (and other tools) to process response 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-32 (helper)

  Supporting helper recursively converts timestamp fields in the data to formatted datetime strings, called 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