mcp-bcrp

Instructions

Implementation Reference

• mcp_bcrp/server.py:52-88 (handler)

  The _get_data function is the internal helper function that performs the actual data fetching logic from the BCRP client.

  async def _get_data(series_codes: list[str], period: str = None) -> str:
      try:
          logger.info(f"Fetching data for: {series_codes} range: {period}")
          
          # Parse period if needed, but client handles basic string appending
          # We might need to handle the specific format "start_date/end_date" if provided as one string
          start = None
          end = None
          start = None
          end = None
          if period:
              parts = period.split('/')
              if len(parts) == 2:
                  start, end = parts
              elif len(parts) == 1:
                   # Check if it looks like a year "YYYY"
                   if len(period) == 4 and period.isdigit():
                       start = f"{period}-01"
                       end = f"{period}-12"
                   else:
                       start = period # fallback
                       # If only start is provided, client won't append it currently.
                       # We should probably set end to 'now' or similar if start is provided?
                       # Or rely on client update. But client needs start AND end.
                       # If only start provided, let's duplicate it? or leave end=None?
                       # If I set end=start, it fetches one month.
                       pass
          
          df = await bcrp_client.get_series(series_codes, start_date=start, end_date=end)
          
          if df.empty:
              return "No data found for the specified parameters."
              
          return df.to_json(orient='records', date_format='iso')
      except Exception as e:
          logger.error(f"Fetch failed: {e}")
          return f"Error fetching data: {str(e)}"

• mcp_bcrp/server.py:109-122 (registration)

  The get_data tool definition which is registered with FastMCP and calls the internal _get_data function.

  @mcp.tool()
  async def get_data(series_codes: list[str], period: str = None) -> str:
      """
      Fetch time series data for specific BCRP series codes.
      
      Args:
          series_codes: List of BCRP series codes (e.g., ["PN01652XM", "PD04638PD"])
          period: Date range in format 'YYYY-MM/YYYY-MM' or single 'YYYY-MM'.
                  If None, returns all available data.
      
      Returns:
          JSON string with array of records containing 'time' and values.
      """
      return await _get_data(series_codes, period)