China Stock MCP

Instructions

Implementation Reference

• src/china_stock_mcp/server.py:720-722 (registration)

  Registration of the 'get_stock_fhps_detail' tool using the @mcp.tool decorator with name and description.

  @mcp.tool(
      name="get_stock_fhps_detail", description="获取指定股票的分红配送情况"
  )

• src/china_stock_mcp/server.py:723-749 (handler)

  Handler function implementing the tool logic: fetches stock dividend/distribution details (FHPS) using fallback data sources (em, ths, cninfo) via akshare, handles empty data, and formats output.

  def get_stock_fhps_detail(
      symbol: Annotated[str, Field(description="股票代码 (例如: '000001')")],
      output_format: Annotated[
          Literal["json", "csv", "xml", "excel", "markdown", "html"],
          Field(description="输出数据格式: json, csv, xml, excel, markdown, html。默认: markdown"),
      ] = "markdown"
  ) -> str:
      """获取指定股票的分红配送情况，支持降级使用 stock_fhps_detail_ths 和 stock_dividend_cninfo."""
      def _fhps_detail_fetcher(source: str, **kwargs: Any) -> pd.DataFrame:
          if source == "em":
              return ak.stock_fhps_detail_em(**kwargs)
          elif source == "ths":
              return ak.stock_fhps_detail_ths(**kwargs)
          elif source == "cninfo":           
              return ak.stock_dividend_cninfo(symbol=kwargs["symbol"])
          else:
              raise ValueError(f"不支持的数据源: {source}")
  
      df = _fetch_data_with_fallback(
          fetch_func=_fhps_detail_fetcher,
          primary_source="em",
          fallback_sources=["ths", "cninfo"],
          symbol=symbol,
      )     
      if df.empty:
          df = pd.DataFrame()
      return _format_dataframe_output(df, output_format)

• src/china_stock_mcp/server.py:731-739 (helper)

  Inner helper function to fetch FHPS data from different sources (eastmoney 'em', ths, cninfo).

  def _fhps_detail_fetcher(source: str, **kwargs: Any) -> pd.DataFrame:
      if source == "em":
          return ak.stock_fhps_detail_em(**kwargs)
      elif source == "ths":
          return ak.stock_fhps_detail_ths(**kwargs)
      elif source == "cninfo":           
          return ak.stock_dividend_cninfo(symbol=kwargs["symbol"])
      else:
          raise ValueError(f"不支持的数据源: {source}")