Wikipedia MCP Server

Instructions

Implementation Reference

• wikipedia_mcp/server.py:211-220 (handler)

  MCP tool handler for 'get_related_topics'. Registers the tool via @server.tool() decorator and implements minimal logic by delegating to WikipediaClient.get_related_topics().

  @server.tool()
  def get_related_topics(title: str, limit: int = 10) -> Dict[str, Any]:
      """
      Get topics related to a Wikipedia article based on links and categories.
  
      Returns a list of related topics up to the specified limit.
      """
      logger.info(f"Tool: Getting related topics for: {title}")
      related = wikipedia_client.get_related_topics(title, limit=limit)
      return {"title": title, "related_topics": related}

• wikipedia_mcp/wikipedia_client.py:689-745 (helper)

  Core implementation of get_related_topics in WikipediaClient. Fetches the page, extracts links and categories, retrieves summaries for top links up to the limit, and falls back to categories.

  def get_related_topics(self, title: str, limit: int = 10) -> List[Dict[str, Any]]:
      """
      Get topics related to a Wikipedia article based on links and categories.
  
      Args:
          title: The title of the Wikipedia article.
          limit: Maximum number of related topics to return.
  
      Returns:
          A list of related topics.
      """
      try:
          page = self.wiki.page(title)
  
          if not page.exists():
              return []
  
          # Get links from the page
          links = list(page.links.keys())
  
          # Get categories
          categories = list(page.categories.keys())
  
          related = []
  
          # Add links first
          for link in links[:limit]:
              link_page = self.wiki.page(link)
              if link_page.exists():
                  related.append(
                      {
                          "title": link,
                          "summary": (
                              link_page.summary[:200] + "..."
                              if len(link_page.summary) > 200
                              else link_page.summary
                          ),
                          "url": link_page.fullurl,
                          "type": "link",
                      }
                  )
              if len(related) >= limit:
                  break
  
          # Add categories if we still have room
          remaining = limit - len(related)
          if remaining > 0:
              for category in categories[:remaining]:
                  # Remove "Category:" prefix if present
                  clean_category = category.replace("Category:", "")
                  related.append({"title": clean_category, "type": "category"})
  
          return related
      except Exception as e:
          logger.error(f"Error getting related topics: {e}")
          return []

• wikipedia_mcp/server.py:211-220 (registration)

  The @server.tool() decorator registers 'get_related_topics' as an MCP tool on the FastMCP server.

  @server.tool()
  def get_related_topics(title: str, limit: int = 10) -> Dict[str, Any]:
      """
      Get topics related to a Wikipedia article based on links and categories.
  
      Returns a list of related topics up to the specified limit.
      """
      logger.info(f"Tool: Getting related topics for: {title}")
      related = wikipedia_client.get_related_topics(title, limit=limit)
      return {"title": title, "related_topics": related}