A Share MCP

Instructions

Implementation Reference

• src/tools/macroeconomic.py:25-31 (handler)

  The primary tool handler for 'get_deposit_rate_data'. It is decorated with @app.tool() which defines the tool schema from its signature and docstring. The handler delegates to the use case function with standardized error handling via run_tool_with_handling.

  @app.tool()
  def get_deposit_rate_data(start_date: Optional[str] = None, end_date: Optional[str] = None, limit: int = 250, format: str = "markdown") -> str:
      """Benchmark deposit rates."""
      return run_tool_with_handling(
          lambda: fetch_deposit_rate_data(active_data_source, start_date=start_date, end_date=end_date, limit=limit, format=format),
          context="get_deposit_rate_data",
      )

• mcp_server.py:55-55 (registration)

  Registration of the macroeconomic tools module, which includes the 'get_deposit_rate_data' tool, called during app initialization.

  register_macroeconomic_tools(app, active_data_source)

• src/data_source_interface.py:98-100 (schema)

  Abstract method in FinancialDataSource interface defining the expected signature for fetching deposit rate data, serving as a contract/schema for implementations.

  @abstractmethod
  def get_deposit_rate_data(self, start_date: Optional[str] = None, end_date: Optional[str] = None) -> pd.DataFrame:
      """Fetches benchmark deposit rates."""

• src/use_cases/macroeconomic.py:9-13 (helper)

  Helper use case function that orchestrates validation, data fetching from data source, and output formatting for the deposit rate tool.

  def fetch_deposit_rate_data(data_source: FinancialDataSource, *, start_date: Optional[str], end_date: Optional[str], limit: int, format: str) -> str:
      validate_output_format(format)
      df = data_source.get_deposit_rate_data(start_date=start_date, end_date=end_date)
      meta = {"dataset": "deposit_rate", "start_date": start_date, "end_date": end_date}
      return format_table_output(df, format=format, max_rows=limit, meta=meta)

• src/baostock_data_source.py:664-666 (helper)

  Implementation of the data source method using Baostock's query_deposit_rate_data API, wrapped by a generic macro data fetcher.

  def get_deposit_rate_data(self, start_date: Optional[str] = None, end_date: Optional[str] = None) -> pd.DataFrame:
      """Fetches benchmark deposit rates using Baostock."""
      return _fetch_macro_data(bs.query_deposit_rate_data, "Deposit Rate", start_date, end_date)