A-Share MCP Server

Instructions

Implementation Reference

• src/tools/date_utils.py:69-75 (handler)

  The MCP tool handler for get_recent_trading_range. It is decorated with @app.tool() and delegates execution to the use case layer via run_tool_with_handling for error handling.

  @app.tool()
  def get_recent_trading_range(days: int = 5) -> str:
      """Return a date range string covering the recent N trading days."""
      return run_tool_with_handling(
          lambda: uc_date.get_recent_trading_range(active_data_source, days=days),
          context=f"get_recent_trading_range:{days}",
      )

• mcp_server.py:56-56 (registration)

  The call to register_date_utils_tools, which includes the registration of the get_recent_trading_range tool via @app.tool() decorators.

  register_date_utils_tools(app, active_data_source)

• src/use_cases/date_utils.py:91-99 (helper)

  Core helper function implementing the logic to compute the recent trading range by fetching trading days and selecting the last N days.

  def get_recent_trading_range(data_source: FinancialDataSource, *, days: int) -> str:
      today = datetime.now()
      start = (today - timedelta(days=days * 2)).strftime("%Y-%m-%d")
      end = today.strftime("%Y-%m-%d")
      df = _fetch_trading_days(data_source, start_date=start, end_date=end)
      trading_days = df[df["is_trading_day"] == "1"]["calendar_date"].tolist()
      if not trading_days:
          return ""
      return f"{trading_days[-days]} 至 {trading_days[-1]}" if len(trading_days) >= days else f"{trading_days[0]} 至 {trading_days[-1]}"