Juhe News

Provides up-to-date headlines and article content via MCP for LLMs using Juhe News data.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "juhemcp-jnews-mcp-server": {
      "command": "uvx",
      "args": [
        "jnews-mcp-server"
      ],
      "env": {
        "JUHE_NEWS_API_KEY": "your_api_key"
      }
    }
  }
}

You can run the Juhe News MCP Server to provide up-to-date headlines and detailed article content to your language models. It exposes two tools for getting today’s hot news headlines and the corresponding detailed content across categories like top, domestic, technology, and sports.

How to use

You interact with the server through an MCP client to fetch current headlines and article details. Use the first tool to retrieve a list of today’s hot headlines by optional type, and use the second tool to fetch the detailed content for a specific headline by its unique key. The tools are designed to return text, images, or embedded resources so you can present rich news content in your workflows.

Get a list of headlines: request headlines with an optional type such as top, domestic, technology, or sports. The server returns a list of items including headlines and media content. - Get headline content: for a specific headline, pass its unique key to obtain the full content and media associated with that story.

How to install

Prerequisites: Python 3.10 or higher must be installed on your system.

Option A: Using uvx (recommended) to run the MCP server directly.

Install the server runtime (uvx is used to run the MCP server directly):

uvx jnews-mcp-server

Option B: Install via PIP and run as a Python module

Install the package using pip.

pip install jnews-mcp-server

Environment variables you must set

Set your Juhe News API key as an environment variable so the MCP server can fetch headlines from the third-party API.

JUHE_NEWS_API_KEY=your_api_key

Run the server after installation

If you installed via uvx, run the MCP server with:

uvx jnews-mcp-server

If you installed via pip, run the MCP server as a Python module:

python -m jnews_mcp_server

Claude Desktop configuration (MCP integration)

To add the Juhe News MCP Server to Claude Desktop, configure the MCP server with the following entry for uvx or Python execution.

Available tools

get_news_list

Retrieves today’s hot headlines, optionally filtered by type (e.g., top, domestic, technology, sports). Returns a list containing text, image, or embedded resources.

get_news_content

Fetches detailed content for a headline specified by its unique key. Returns a combination of text, images, or embedded resources.