jnews-mcp-server

🚀 聚合新闻 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

"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条新闻的详细内容"