what is Juhe News MCP Server?
Juhe News MCP Server is a Model Context Protocol server that provides access to the latest news headlines across various categories such as recommendations, domestic news, technology, and sports.
how to use Juhe News MCP Server?
To use the server, you can either run it using the recommended uv tool or install it via pip. After installation, you can access news headlines by calling the provided functions with the appropriate parameters.
key features of Juhe News MCP Server?
- Fetches today's trending news headlines based on type.
- Provides detailed content for specific news articles.
- Easy installation and configuration with environment variables.
use cases of Juhe News MCP Server?
- Retrieving the latest technology news headlines.
- Accessing detailed content for specific news articles.
- Integrating news fetching capabilities into applications.
FAQ from Juhe News MCP Server?
- What programming language is required to run the server?
Python 3.10 or higher is required.
- How do I get the API key for news headlines?
You can obtain the API key from Juhe's API documentation.
- Can I debug the server?
Yes, you can use the MCP inspector for debugging.
Juhe News MCP Server
一个提供新闻头条信息功能的模型上下文协议（Model Context Protocol）服务器。该服务器使大型语言模型（LLMs）能够获取当前最新的热点新闻头条（包括：推荐、国内、科技、体育等类型）及详细内容信息。
Components
Tools
服务器实现了两个工具:
- get_news_list: 根据新闻类型获取今日热点新闻头条
- 需要传入 "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: 根据新闻类型获取今日热点新闻头条
- 需要传入 "uniquekey"（新闻id）作为必须的字符串参数。
async def get_news_content(uniquekey: str) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
Install
This server requires Python 3.10 or higher. Install dependencies using uv (recommended) or pip
Using uv (recommended)
When using uv no specific installation is needed. 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 as a script using:
python -m jnews_mcp_server
Configuration
Environment Variables
JUHE_NEWS_API_KEY: 聚合数据的新闻头条API密钥。获取：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
Using uvx
"mcpServers": {
"jnews-mcp-server": {
"command": "uvx",
"args": [
"jnews-mcp-server"
],
"env": {
"JUHE_NEWS_API_KEY": "your_api_key"
}
}
}
Using pip installation
"mcpServers": {
"jnews-mcp-server": {
"command": "python",
"args": [
"-m",
"jnews_mcp_server"
],
"env": {
"JUHE_NEWS_API_KEY": "your_api_key"
}
}
}
Debugging
You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx jnews-mcp-server
Or if you've installed the package in a specific directory or are developing on it:
cd path/to/servers/src/jnews-mcp-server
npx @modelcontextprotocol/inspector uv run jnews-mcp-server
Examples of Questions for Cline
- "今日有哪些热点新闻?"
- "当前体育热点头条?"
- "第5条新闻的详细内容"
