China Stock MCP

Instructions

Implementation Reference

• src/china_stock_mcp/server.py:769-771 (registration)

  Registration of the 'get_stock_research_report' tool using the @mcp.tool decorator.

  @mcp.tool(
      name="get_stock_research_report", description="获取指定股票的个股研报及盈利预测"
  )

• src/china_stock_mcp/server.py:772-783 (handler)

  The handler function implementing the tool logic. Includes input schema via Annotated[Field] for symbol and output_format parameters. Fetches research report data from akshare and formats the output.

  def get_stock_research_report(
      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:
      """获取指定股票的个股研报及盈利预测."""
      df = ak.stock_research_report_em(symbol=symbol)
      if df.empty:
          df = pd.DataFrame()
      return _format_dataframe_output(df, output_format)