mcp-reddit

Instructions

Implementation Reference

• src/mcp_reddit/reddit_fetcher.py:19-50 (handler)

  The main handler function for the 'fetch_reddit_hot_threads' tool. It fetches hot posts from a specified subreddit using the redditwarp client, formats post information including title, score, comments, author, type, content, and link, and returns a formatted string. Registered via @mcp.tool() decorator.

  @mcp.tool()
  async def fetch_reddit_hot_threads(subreddit: str, limit: int = 10) -> str:
      """
      Fetch hot threads from a subreddit
  
      Args:
          subreddit: Name of the subreddit
          limit: Number of posts to fetch (default: 10)
  
      Returns:
          Human readable string containing list of post information
      """
      try:
          posts = []
          async for submission in client.p.subreddit.pull.hot(subreddit, limit):
              post_info = (
                  f"Title: {submission.title}\n"
                  f"Score: {submission.score}\n"
                  f"Comments: {submission.comment_count}\n"
                  f"Author: {submission.author_display_name or '[deleted]'}\n"
                  f"Type: {_get_post_type(submission)}\n"
                  f"Content: {_get_content(submission)}\n"
                  f"Link: https://reddit.com{submission.permalink}\n"
                  f"---"
              )
              posts.append(post_info)
  
          return "\n\n".join(posts)
  
      except Exception as e:
          logging.error(f"An error occurred: {str(e)}")
          return f"An error occurred: {str(e)}"

• src/mcp_reddit/reddit_fetcher.py:104-112 (helper)

  Helper function to determine the type of a Reddit submission (link, text, gallery, or unknown). Used in post_info formatting.

  def _get_post_type(submission) -> str:
      """Helper method to determine post type"""
      if isinstance(submission, LinkPost):
          return 'link'
      elif isinstance(submission, TextPost):
          return 'text'
      elif isinstance(submission, GalleryPost):
          return 'gallery'
      return 'unknown'

• src/mcp_reddit/reddit_fetcher.py:114-122 (helper)

  Helper function to extract appropriate content or link from a Reddit submission based on its type. Used in post_info formatting.

  def _get_content(submission) -> Optional[str]:
      """Helper method to extract post content based on type"""
      if isinstance(submission, LinkPost):
          return submission.permalink
      elif isinstance(submission, TextPost):
          return submission.body
      elif isinstance(submission, GalleryPost):
          return str(submission.gallery_link)
      return None