Jnews MCP Server

🚀 Aggregated News MCP Server

This is a Model Context Protocol (MCP) server that provides news headline information. The server enables Large Language Models (LLMs) to access the latest hot news headlines (including types such as recommended, domestic, technology, sports, etc.) and detailed content information.

✨ Features

Tools

The server implements two tools:

• get_news_list: Retrieve today's hot news headlines based on the news type.

  • It requires an optional string parameter "type" (news type).

  async def get_news_list(type: str = "top", page: int = 1, page_size: int = 20) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
  

• get_news_content: Retrieve today's hot news headlines based on the news type.

  • It requires a mandatory string parameter "uniquekey" (news ID).

  async def get_news_content(uniquekey: str) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
  

📦 Installation

This server requires Python 3.10 or higher. Install the dependencies using uv (recommended) or pip.

Using uv (Recommended)

When using uv, no specific installation is required. We will use uvx to directly run jnews-mcp-server.

uvx jnews-mcp-server

Using pip

Alternatively, you can install jnews-mcp-server via pip:

pip install jnews-mcp-server

After installation, you can run it using the following command:

python -m jnews_mcp_server

📚 Documentation

Configuration

Environment Variables

JUHE_NEWS_API_KEY: The API key for the news headlines API of Juhe Data. Obtain it from: https://www.juhe.cn/docs/api/id/235

JUHE_NEWS_API_KEY=your_api_key

Claude Desktop

• On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

Debugging

You can use the MCP inspector to debug the server. For uvx installation:

npx @modelcontextprotocol/inspector uvx jnews-mcp-server 

Or if you installed the package in a specific directory or are in development:

cd path/to/servers/src/jnews-mcp-server
npx @modelcontextprotocol/inspector uv run jnews-mcp-server

Command-line Example Questions

1. "What are the hot news today?"
2. "What are the current sports hot headlines?"
3. "What is the detailed content of the 5th news?"