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]}"