Juhemcp Jnews MCP Server

🚀 聚合新闻 MCP 服务器

聚合新闻 MCP 服务器是一个基于模型上下文协议（Model Context Protocol）的服务器，它能够为大型语言模型（LLMs）提供最新的热点新闻头条及详细内容信息，涵盖推荐、国内、科技、体育等多种类型。

🚀 快速开始

聚合新闻 MCP 服务器可让大型语言模型获取各类新闻信息。你只需按照以下步骤安装和配置，即可使用其提供的新闻获取工具。

✨ 主要特性

• 提供多种类型的新闻头条信息，包括推荐、国内、科技、体育等。
• 实现了两个实用工具，可根据新闻类型或新闻 ID 获取新闻头条和详细内容。

📦 安装指南

该服务器需要 Python 3.10 或更高版本。你可以选择使用 uv（推荐）或 pip 安装依赖项。

使用 uv (推荐)

当使用 uv 时，无需进行特定安装。我们将使用 uvx 直接运行 jnews-mcp-server。

uvx jnews-mcp-server

使用 pip 安装

你也可以通过 pip 安装 jnews-mcp-server：

pip install jnews-mcp-server

安装完成后，可以通过以下命令运行它作为脚本：

python -m jnews_mcp_server

💻 使用示例

基础用法

服务器实现了两个工具，以下是它们的使用示例：

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]:

示例调用：

# 假设 types 模块已正确导入
import asyncio

async def main():
    result = await get_news_list(type="sports")
    print(result)

asyncio.run(main())

get_news_content

根据新闻类型获取今日热点新闻头条，需要传入 "uniquekey"（新闻id）作为必需的字符串参数。

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

示例调用：

import asyncio

async def main():
    news_id = "your_news_id"
    result = await get_news_content(uniquekey=news_id)
    print(result)

asyncio.run(main())

📚 详细文档

配置

环境变量

JUHE_NEWS_API_KEY 是聚合数据的新闻头条 API 密钥，你可以从 https://www.juhe.cn/docs/api/id/235 获取。

JUHE_NEWS_API_KEY=your_api_key

Claude Desktop 配置

• MacOS：配置文件路径为 ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：配置文件路径为 %APPDATA%/Claude/claude_desktop_config.json

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

"mcpServers": {
  "jnews-mcp-server": {
    "command": "python",
    "args": [
      "-m",
      "jnews_mcp_server"
    ],
    "env": {
      "JUHE_NEWS_API_KEY": "your_api_key"
    }
  }
}

调试

你可以使用 MCP 检查器来调试服务器。

uvx 安装调试

npx @modelcontextprotocol/inspector uvx jnews-mcp-server 

特定目录安装或开发调试

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

示例问题

你可以向服务器提出以下示例问题：

1. "今日有哪些热点新闻?"
2. "当前体育热点头条?"
3. "第 5 条新闻的详细内容"