Dev.to MCP Server

Instructions

Implementation Reference

• server.py:28-32 (handler)

  The handler function for the 'get_top_articles' tool. It fetches top articles from the Dev.to API endpoint '/articles' using the helper fetch_from_api and formats the first 10 using format_articles.

  @mcp.tool()
  async def get_top_articles() -> str:
      """Get the top articles from Dev.to"""
      articles = await fetch_from_api("/articles")
      return format_articles(articles[:10])  # Limiting to 10 for readability

• server.py:12-18 (helper)

  Helper function used by get_top_articles to make HTTP requests to the Dev.to API.

  async def fetch_from_api(path: str, params: dict = None) -> dict:
      """Helper function to fetch data from Dev.to API"""
      async with httpx.AsyncClient() as client:
          url = f"{BASE_URL}{path}"
          response = await client.get(url, params=params, timeout=10.0)
          response.raise_for_status()
          return response.json()

• server.py:168-188 (helper)

  Helper function used by get_top_articles to format the list of articles into a readable markdown string.

  def format_articles(articles: list) -> str:
      """Format a list of articles for display"""
      if not articles:
          return "No articles found."
      
      result = "# Dev.to Articles\n\n"
      for article in articles:
          title = article.get("title", "Untitled")
          author = article.get("user", {}).get("name", "Unknown Author")
          published_date = article.get("readable_publish_date", "Unknown date")
          article_id = article.get("id", "")
          tags = article.get("tags", "")
          
          result += f"## {title}\n"
          result += f"ID: {article_id}\n"
          result += f"Author: {author}\n"
          result += f"Published: {published_date}\n"
          result += f"Tags: {tags}\n"
          result += f"Description: {article.get('description', 'No description available.')}\n\n"
      
      return result