crypto-rss-mcp

Instructions

Retrieve a list of available cryptocurrency RSS feeds from a local or remote OPML file, optionally filtered by keyword.

Parameters:
    keyword (str, optional): Filter feeds where the keyword appears in the description or category (case-insensitive).
    opml_file (str, optional): Path to a local OPML file to read feeds from. If not provided, fetches from the remote OPML URL.

Returns:
    str: A formatted string listing each RSS feed URL, its description, and category, parsed from the OPML file.

Implementation Reference

• src/crypto_rss_mcp/cli.py:103-103 (registration)

  Registers the get_crypto_rss_list tool with the FastMCP server.

  @mcp.tool()

• src/crypto_rss_mcp/cli.py:104-114 (schema)

  Defines the input parameters, docstring describing usage, parameters, and return type for the tool.

  async def get_crypto_rss_list(keyword: str = None, opml_file: str = "RAW.opml") -> str:
      """
      Retrieve a list of available cryptocurrency RSS feeds from a local or remote OPML file, optionally filtered by keyword.
      
      Parameters:
          keyword (str, optional): Filter feeds where the keyword appears in the description or category (case-insensitive).
          opml_file (str, optional): Path to a local OPML file to read feeds from. If not provided, fetches from the remote OPML URL.
      
      Returns:
          str: A formatted string listing each RSS feed URL, its description, and category, parsed from the OPML file.
      """

• src/crypto_rss_mcp/cli.py:115-129 (handler)

  Executes the tool logic: loads feeds from OPML, filters by keyword if provided, formats and returns the list as a string.

  feeds = load_rss_feeds_from_opml(opml_file=opml_file)
  if keyword:
      keyword = keyword.lower()
      feeds = [
          feed for feed in feeds
          if keyword in feed['description'].lower() or keyword in (feed['category'] or '').lower()
      ]
  result = "Available Cryptocurrency RSS Feeds:\n\n"
  if not feeds:
      result += "No feeds found matching the keyword.\n"
  for feed in feeds:
      result += f"Category: {feed['category'] or 'Uncategorized'}\n"
      result += f"URL: {feed['url']}\n"
      result += f"Description: {feed['description']}\n\n"
  return result

• src/crypto_rss_mcp/cli.py:14-54 (helper)

  Helper function called by the handler to parse the OPML file and extract list of RSS feeds with URLs, descriptions, and categories.

  def load_rss_feeds_from_opml(opml_file: str) -> List[dict]:
      """Load RSS feeds from an OPML file."""
      try:
          outline = opml.parse(opml_file)
          feeds = []
          def parse_outline(items, category: str = ""):
              for item in items:
                  print(item, hasattr(item, "__iter__"))
                  if hasattr(item, "xmlUrl") and item.xmlUrl:
                      # Collect feed with URL, description, and optional category
                      feeds.append({
                          "url": item.xmlUrl,
                          "description": item.title or item.text or "No description available",
                          "category": category
                      })
                  # Recursively process nested outlines
          def parse_outline(items, category: str = ""):
              for item in items:
                  if hasattr(item, "xmlUrl") and item.xmlUrl:
                      # Collect feed with URL, description, and optional category
                      feeds.append({
                          "url": item.xmlUrl,
                          "description": item.title or item.text or "No description available",
                          "category": category
                      })
                  # Recursively process nested outlines (children)
                  try:
                      # Iterate over item as a container of child outlines
                      parse_outline(item, category=item.title or item.text or category)
                  except TypeError:
                      # If item is not iterable, skip to next item
                      continue
                  
          # Start parsing from top-level outlines
          parse_outline(outline)
          return feeds
      except FileNotFoundError:
          raise RuntimeError(f"OPML file not found: {OPML_FILE}")
      except Exception as e:
          raise RuntimeError(f"Failed to parse OPML file: {str(e)}")