geeknews-mcp-server

Instructions

        GeekNews에서 주간 뉴스를 가져오는 도구
        
        Args:
            weekly_id: 주간 뉴스 ID (빈 문자열인 경우 가장 최근 주간 뉴스를 가져옴)
            
        Returns:
            Dict[str, Any]: 주간 뉴스 정보
        

Implementation Reference

• src/server.py:105-138 (handler)

  Core handler function implementing the get_weekly_news tool logic: checks cache validity, loads from cache if valid, otherwise refreshes via scheduler, handles errors.

  def _get_weekly_news(self, weekly_id: str = "") -> Dict[str, Any]:
      """
      GeekNews에서 주간 뉴스를 가져옵니다.
      
      Args:
          weekly_id: 주간 뉴스 ID (빈 문자열인 경우 가장 최근 주간 뉴스를 가져옴)
          
      Returns:
          Dict[str, Any]: 주간 뉴스 정보
      """
      cache_id = weekly_id if weekly_id else "latest"
      
      try:
          # 캐시에서 데이터 로드 시도
          is_valid, cached_data = self.cache_manager.get_weekly_news_cache(cache_id)
          
          if is_valid and cached_data:
              logger.info(f"주간 뉴스 캐시 사용 (ID: {cache_id})")
              return cached_data
          
          # 캐시가 없거나 유효하지 않은 경우 데이터 갱신
          logger.info(f"주간 뉴스 데이터 갱신 (ID: {cache_id})")
          return self.scheduler.refresh_weekly_news(weekly_id)
      except Exception as e:
          logger.error(f"주간 뉴스 가져오기 실패: {e}", exc_info=True)
          return {
              "title": "GeekNews Weekly",
              "number": 0,
              "id": weekly_id if weekly_id else "",
              "content": "주간 뉴스를 가져오는 중 오류가 발생했습니다.",
              "url": f"{self.client.base_url}/weekly" + (f"/{weekly_id}" if weekly_id else ""),
              "items": []
          }

• src/server.py:91-102 (registration)

  Registers the get_weekly_news tool with MCP server using @mcp.tool() decorator, defines input schema via args and docstring.

  @self.mcp.tool()
  def get_weekly_news(weekly_id: str = "") -> Dict[str, Any]:
      """
      GeekNews에서 주간 뉴스를 가져오는 도구
      
      Args:
          weekly_id: 주간 뉴스 ID (빈 문자열인 경우 가장 최근 주간 뉴스를 가져옴)
          
      Returns:
          Dict[str, Any]: 주간 뉴스 정보
      """
      return self._get_weekly_news(weekly_id)

• src/server.py:92-102 (schema)

  Tool function signature and docstring defining input (weekly_id: str) and output schema.

  def get_weekly_news(weekly_id: str = "") -> Dict[str, Any]:
      """
      GeekNews에서 주간 뉴스를 가져오는 도구
      
      Args:
          weekly_id: 주간 뉴스 ID (빈 문자열인 경우 가장 최근 주간 뉴스를 가져옴)
          
      Returns:
          Dict[str, Any]: 주간 뉴스 정보
      """
      return self._get_weekly_news(weekly_id)

• src/cache.py:187-199 (helper)

  Helper function to load and validate weekly news cache data.

  def get_weekly_news_cache(self, weekly_id: str = "latest") -> Tuple[bool, Dict[str, Any]]:
      """
      주간 뉴스 캐시를 로드합니다.
      
      Args:
          weekly_id: 주간 뉴스 ID (빈 문자열인 경우 "latest" 사용)
          
      Returns:
          Tuple[bool, Dict[str, Any]]: (캐시 유효 여부, 주간 뉴스 정보)
      """
      cache_key = f"weekly_{weekly_id if weekly_id else 'latest'}"
      return self.load_cache(cache_key)

• src/models.py:40-62 (schema)

  Dataclass defining the structure of WeeklyNews output.

  @dataclass
  class WeeklyNews:
      """
      GeekNews 주간 뉴스 클래스
      
      주간 뉴스의 제목, 번호, ID, 내용, URL 등의 정보를 저장합니다.
      """
      title: str
      number: int
      id: str
      content: str
      url: str
      items: List[Dict[str, Any]]
      
      def to_dict(self) -> Dict[str, Any]:
          """
          주간 뉴스를 딕셔너리로 변환
          
          Returns:
              Dict[str, Any]: 주간 뉴스 정보를 담은 딕셔너리
          """
          return asdict(self)