get_growth_data
Retrieve quarterly growth capability data for A-share stocks to analyze financial performance trends and investment potential.
Instructions
Quarterly growth capability data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| year | Yes | ||
| quarter | Yes | ||
| limit | No | ||
| format | No | markdown |
Implementation Reference
- src/tools/financial_reports.py:47-53 (handler)The primary handler for the 'get_growth_data' MCP tool. This @app.tool()-decorated function implements the tool logic by delegating to the fetch_growth_data use case with error handling.
@app.tool() def get_growth_data(code: str, year: str, quarter: int, limit: int = 250, format: str = "markdown") -> str: """Quarterly growth capability data.""" return run_tool_with_handling( lambda: fetch_growth_data(active_data_source, code=code, year=year, quarter=quarter, limit=limit, format=format), context=f"get_growth_data:{code}:{year}Q{quarter}", ) - mcp_server.py:52-52 (registration)Invocation of register_financial_report_tools during server startup, which registers the get_growth_data tool (and other financial report tools) with the FastMCP app.
register_financial_report_tools(app, active_data_source) - Helper use case function called by the tool handler. Performs input validation, fetches raw growth data from the data source, and formats the output as markdown table.
def fetch_growth_data(data_source: FinancialDataSource, *, code: str, year: str, quarter: int, limit: int, format: str) -> str: validate_year(year) validate_quarter(quarter) validate_output_format(format) df = data_source.get_growth_data(code=code, year=year, quarter=quarter) return _format_financial_df(df, code=code, year=year, quarter=quarter, dataset="Growth", format=format, limit=limit) - src/tools/financial_reports.py:48-53 (schema)Input schema defined by function signature and docstring for the MCP tool.
def get_growth_data(code: str, year: str, quarter: int, limit: int = 250, format: str = "markdown") -> str: """Quarterly growth capability data.""" return run_tool_with_handling( lambda: fetch_growth_data(active_data_source, code=code, year=year, quarter=quarter, limit=limit, format=format), context=f"get_growth_data:{code}:{year}Q{quarter}", )