Juhe News MCP Server

Instructions

Implementation Reference

• src/jnews_mcp_server/server.py:82-110 (handler)

  The main handler function for the 'get_news_list' tool. It constructs an API request to the Juhe news service with the provided parameters (type, page, page_size) and returns the news list as TextContent or an error message.

  async def get_news_list(type: str = "top", page: int = 1, page_size: int = 20) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
      """
      根据新闻类型获取今日热点新闻头条.
      """
      url = f"{JUHE_NEWS_API_BASE}/index"
      params = {
          "type": type,
          "page": page,
          "page_size": page_size,
          "key": JUHE_NEWS_API_KEY
      }
      async with httpx.AsyncClient() as client:
          response = await client.get(url, params=params)
          data = response.json()
          if data["error_code"] == 0:
              news_list = data["result"]["data"]
              return [
                  types.TextContent(
                      type="text",
                      text=f"{news_list}"
                  )
              ]
          else:
              return [
                  types.TextContent(
                      type="text",
                      text=f"Error: {data['reason']}"
                  )
              ]

• src/jnews_mcp_server/server.py:28-42 (schema)

  Defines the input JSON schema for the 'get_news_list' tool, specifying properties for 'type', 'page', and 'page_size'.

  inputSchema={
      "type": "object",
      "properties": {
          "type": {
              "type": "string", "description": "新闻类型:top(推荐,默认),guonei(国内),guoji(国际),yule(娱乐),tiyu(体育),junshi(军事),keji(科技),caijing(财经),youxi(游戏),qiche(汽车),jiankang(健康)",
          },
          "page": {
              "type": "number", "description": "当前页数, 默认1, 最大50"
          },
          "page_size": {
              "type": "number", "description": "每页返回新闻条数, 默认20, 最大50"
          },
      },
      # "required": ["type"],
  },

• src/jnews_mcp_server/server.py:25-43 (registration)

  Registers the 'get_news_list' tool with the MCP server via the list_tools handler, including its name, description, and schema.

  types.Tool(
      name="get_news_list",
      description="通过新闻类型获取今日热点新闻头条",
      inputSchema={
          "type": "object",
          "properties": {
              "type": {
                  "type": "string", "description": "新闻类型:top(推荐,默认),guonei(国内),guoji(国际),yule(娱乐),tiyu(体育),junshi(军事),keji(科技),caijing(财经),youxi(游戏),qiche(汽车),jiankang(健康)",
              },
              "page": {
                  "type": "number", "description": "当前页数, 默认1, 最大50"
              },
              "page_size": {
                  "type": "number", "description": "每页返回新闻条数, 默认20, 最大50"
              },
          },
          # "required": ["type"],
      },
  ),

• src/jnews_mcp_server/server.py:65-67 (helper)

  Dispatches calls to the 'get_news_list' tool handler within the call_tool function, extracting the 'type' parameter and invoking the handler.

  if name == "get_news_list":
      type_value = type_value = arguments.get("type", "top") if arguments else "top"
      return await get_news_list(type_value)