Wikipedia MCP Server

Instructions

Implementation Reference

• wikipedia_mcp/server.py:225-234 (registration)

  Registration and thin handler for the 'get_sections' MCP tool using @server.tool() decorator. Delegates core logic to wikipedia_client.get_sections.

  @server.tool()
  def get_sections(title: str) -> Dict[str, Any]:
      """
      Get the sections of a Wikipedia article.
  
      Returns a dictionary with the article title and list of sections.
      """
      logger.info(f"Tool: Getting sections for: {title}")
      sections = wikipedia_client.get_sections(title)
      return {"title": title, "sections": sections}

• wikipedia_mcp/wikipedia_client.py:644-663 (handler)

  Primary handler logic for retrieving Wikipedia article sections using wikipedia-api library. Fetches page.sections and processes with _extract_sections helper.

  def get_sections(self, title: str) -> List[Dict[str, Any]]:
      """
      Get the sections of a Wikipedia article.
  
      Args:
          title: The title of the Wikipedia article.
  
      Returns:
          A list of sections.
      """
      try:
          page = self.wiki.page(title)
  
          if not page.exists():
              return []
  
          return self._extract_sections(page.sections)
      except Exception as e:
          logger.error(f"Error getting Wikipedia sections: {e}")
          return []

• wikipedia_mcp/wikipedia_client.py:749-769 (helper)

  Recursive helper function to extract hierarchical section structure from Wikipedia page.sections, including title, level, text, and subsections.

  def _extract_sections(self, sections, level=0) -> List[Dict[str, Any]]:
      """
      Extract sections recursively.
  
      Args:
          sections: The sections to extract.
          level: The current section level.
  
      Returns:
          A list of sections.
      """
      result = []
      for section in sections:
          section_data = {
              "title": section.title,
              "level": level,
              "text": section.text,
              "sections": self._extract_sections(section.sections, level + 1),
          }
          result.append(section_data)
      return result