A-Share MCP Server

Instructions

Implementation Reference

• src/tools/indices.py:57-63 (handler)

  FastMCP tool handler for 'get_index_constituents', decorated with @app.tool(), delegates to use case via run_tool_with_handling.
  @app.tool() def get_index_constituents(index: str, date: Optional[str] = None, limit: int = 250, format: str = "markdown") -> str: """Generic index constituent fetch (hs300/sz50/zz500).""" return run_tool_with_handling( lambda: fetch_index_constituents(active_data_source, index=index, date=date, limit=limit, format=format), context=f"get_index_constituents:{index}", )
• src/use_cases/indices.py:25-35 (helper)

  Core use case function implementing the logic to fetch, validate, map index key, retrieve data from source, and format output.
  def fetch_index_constituents(data_source: FinancialDataSource, *, index: str, date: Optional[str], limit: int, format: str) -> str: validate_output_format(format) key = validate_index_key(index, INDEX_MAP) if key == "hs300": df = data_source.get_hs300_stocks(date=date) elif key == "sz50": df = data_source.get_sz50_stocks(date=date) else: df = data_source.get_zz500_stocks(date=date) meta = {"index": key, "as_of": date or "latest"} return format_table_output(df, format=format, max_rows=limit, meta=meta)
• src/use_cases/indices.py:8-15 (schema)

  Mapping of index names (English/Chinese) to canonical keys used for input validation in get_index_constituents.
  INDEX_MAP = { "hs300": "hs300", "沪深300": "hs300", "zz500": "zz500", "中证500": "zz500", "sz50": "sz50", "上证50": "sz50", }
• mcp_server.py:53-53 (registration)

  Top-level call to register all index tools, including get_index_constituents.
  register_index_tools(app, active_data_source)