关键词

新闻热点头条资讯聚合数据

使用说明

项目简介

Juhe News MCP Server 是一个基于模型上下文协议 (MCP) 的服务器，旨在为大型语言模型 (LLMs) 提供最新的新闻头条信息。它通过聚合数据API获取新闻数据，并以 MCP 协议标准化的方式提供给 LLM 客户端，使得 LLM 能够便捷地获取和利用实时新闻资讯。

主要功能点

  • 新闻头条查询: 提供 'get_news_list' 工具，允许 LLM 根据新闻类型（如推荐、国内、科技、体育等）获取最新的热点新闻头条列表。
  • 新闻内容查询: 提供 'get_news_content' 工具，允许 LLM 根据新闻ID (uniquekey) 获取新闻的详细内容。
  • 标准MCP协议: 完全遵循 MCP 协议规范，易于集成到任何支持 MCP 协议的 LLM 客户端。
  • 灵活部署: 支持使用 'uvx' 或 'pip' 进行安装和运行，方便用户根据自身环境选择合适的部署方式。

安装步骤

  1. 环境准备: 确保已安装 Python 3.10 或更高版本。
  2. 安装依赖:
    • 推荐 (使用 uvx): 无需显式安装，uvx 会自动处理依赖。
    • 使用 pip: 执行命令 'pip install jnews-mcp-server' 安装。
  3. 配置API密钥:
    • 注册并获取聚合数据新闻头条API密钥：https://www.juhe.cn/docs/api/id/235
    • 设置环境变量 'JUHE_NEWS_API_KEY' 为您的 API 密钥。例如，在终端中执行 'export JUHE_NEWS_API_KEY=your_api_key' (Linux/macOS) 或 'set JUHE_NEWS_API_KEY=your_api_key' (Windows)。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是针对不同安装方式的配置示例，请根据您的实际安装方式选择配置信息。

1. 使用 uvx 运行 (推荐):

{
  "mcpServers": {
    "jnews-mcp-server": {
      "command": "uvx",  // 启动命令为 uvx
      "args": [
        "jnews-mcp-server" // 运行 jnews-mcp-server
      ],
      "env": {
        "JUHE_NEWS_API_KEY": "your_api_key" // 您的聚合数据API密钥
      }
    }
  }
}

2. 使用 pip 安装运行:

{
  "mcpServers": {
    "jnews-mcp-server": {
      "command": "python", // 启动命令为 python
      "args": [
        "-m",
        "jnews_mcp_server" // 运行 jnews_mcp_server 模块
      ],
      "env": {
        "JUHE_NEWS_API_KEY": "your_api_key" // 您的聚合数据API密钥
      }
    }
  }
}

配置说明:

  • '"mcpServers"': MCP 客户端配置 MCP 服务器的顶级字段。
  • '"jnews-mcp-server"': 为该新闻服务器自定义的名称，客户端用此名称引用该服务器。
  • '"command"': 启动服务器的命令。
  • '"args"': 传递给启动命令的参数，以列表形式提供。
  • '"env"': 服务器运行所需的环境变量，例如聚合数据API密钥。请将 '"your_api_key"' 替换为您实际的 API 密钥。

将以上 JSON 配置添加到 MCP 客户端的配置文件中。 例如，对于 Claude 桌面客户端，配置文件路径通常为：

  • macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，即可通过自然语言指令调用新闻服务。

示例问题:

  1. "今日有哪些热点新闻?" (调用 'get_news_list' 工具，默认类型为 "top")
  2. "当前体育热点头条?" (调用 'get_news_list' 工具，类型为 "tiyu")
  3. "请提供 uniquekey 为 '新闻ID' 的新闻详细内容" (调用 'get_news_content' 工具，'新闻ID' 替换为实际的新闻 uniquekey)

注意: LLM 客户端的具体指令方式可能有所不同，请参考您使用的客户端的文档。

信息

分类

网页与API

访问项目