Xueqiu MCP

Instructions

Args:
    fund_code: 基金代码

Implementation Reference

• main.py:431-439 (handler)

  The handler function implementing the 'fund_nav_history' MCP tool. Decorated with @mcp.tool() for automatic registration. Fetches historical NAV data via the pysnowball library (imported as 'ball') and processes the response using the shared process_data helper function.

  @mcp.tool()
  def fund_nav_history(fund_code: str="SZ000002") -> dict:
      """获取基金历史净值数据
      
      Args:
          fund_code: 基金代码
      """
      result = ball.fund_nav_history(fund_code)
      return process_data(result)

• main.py:34-61 (helper)

  Helper function used by the fund_nav_history tool (and others) to post-process raw data from pysnowball, primarily converting timestamps to readable dates.

  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:431-431 (registration)

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

  @mcp.tool()