🚀 聚合新闻 MCP 服务器
这是一个基于模型上下文协议（Model Context Protocol）的服务器，主要功能是提供新闻头条信息。借助该服务器，大型语言模型（LLMs）能够获取当下最新的热点新闻头条（涵盖推荐、国内、科技、体育等多种类型）及其详细内容。
✨ 主要特性
- 提供两种工具，可分别根据新闻类型获取今日热点新闻头条，以及根据新闻id获取新闻详细内容。
- 支持使用uv（推荐）或pip安装依赖。
- 可通过配置环境变量和Claude Desktop进行个性化设置。
- 支持使用MCP检查器进行服务器调试。
📦 安装指南
该服务器要求 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]:
get_news_content
根据新闻类型获取今日热点新闻头条，需要传入 "uniquekey"（新闻id）作为必须的字符串参数。
async def get_news_content(uniquekey: str) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
📚 详细文档
配置
环境变量
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
使用 uvx
"mcpServers": {
"jnews-mcp-server": {
"command": "uvx",
"args": [
"jnews-mcp-server"
],
"env": {
"JUHE_NEWS_API_KEY": "your_api_key"
}
}
}
使用 pip 安装
"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
命令行示例问题
- "今日有哪些热点新闻?"
- "当前体育热点头条?"
- "第5条新闻的详细内容"