HotNews MCP Server 使用说明

项目简介

HotNews MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为大型语言模型 (LLM) 应用提供实时的中文互联网热点新闻资讯。通过标准化的 MCP 协议，该服务器允许 LLM 客户端轻松集成并获取最新的热点话题，从而增强 LLM 在信息检索和内容生成方面的能力。

主要功能点

• 实时热点新闻: 聚合来自9个主流中文社交平台和新闻网站的实时热点话题。
• MCP 协议兼容: 完全兼容 Model Context Protocol，易于与各种 MCP 客户端集成。
• 工具调用: 提供 'get_hot_news' 工具，允许客户端指定平台获取热点列表。
• Markdown 格式输出: 返回内容以 Markdown 格式呈现，包含可点击链接，方便 LLM 处理和展示。
• 热度支持: 在数据源允许的情况下，提供热度指标，帮助评估话题热度。
• 支持平台广泛: 覆盖知乎、36氪、百度、B站、微博、抖音、虎扑、豆瓣、IT之家等热门平台。

安装步骤

HotNews MCP Server 可以通过 NPX 或 Docker 两种方式安装和运行。

方式一：NPX (推荐)

1. 前提条件: 确保已安装 Node.js 和 npm。

2. 配置 MCP 客户端: 在您的 MCP 客户端配置文件中，添加以下 server 配置：

   {
     "mcpServers": {
       "mcp-server-hotnews": {
         "command": "npx",
         "args": [
           "-y",
           "@wopal/mcp-server-hotnews"
         ]
       }
     }
   }
   

   • 'server name': 'mcp-server-hotnews' (服务器名称，客户端用于识别和调用)
   • 'command': 'npx' (启动命令，使用 npx 运行 npm 包)
   • 'args':
     • '-y': (参数，自动确认安装 npm 包)
     • '@wopal/mcp-server-hotnews': (参数，指定要运行的 npm 包名称)

方式二：Docker (需要自行构建镜像)

1. 前提条件: 确保已安装 Docker。

2. 构建 Docker 镜像: 由于官方 Docker 镜像尚未上传至 Docker Hub，您需要自行构建。在仓库根目录下，执行 Docker 构建命令：

   docker build -t wopal/mcp-server-hotnews:latest -f Dockerfile .
   

3. 配置 MCP 客户端: 在您的 MCP 客户端配置文件中，添加以下 server 配置：

   {
     "mcpServers": {
       "mcp-server-hotnews": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "wopal/mcp-server-hotnews"
         ]
       }
     }
   }
   

   • 'server name': 'mcp-server-hotnews' (服务器名称，客户端用于识别和调用)
   • 'command': 'docker' (启动命令，使用 docker 运行容器)
   • 'args':
     • 'run': (参数，docker run 命令)
     • '-i': (参数，保持 STDIN 开放)
     • '--rm': (参数，容器退出后自动删除)
     • 'wopal/mcp-server-hotnews': (参数，指定要运行的 Docker 镜像名称)

基本使用方法

1. 启动 MCP 客户端: 根据您的 MCP 客户端文档启动客户端。客户端将根据配置自动连接到 HotNews MCP Server。

2. 调用 'get_hot_news' 工具: 在您的 LLM 应用或 MCP 客户端中，可以使用 'get_hot_news' 工具获取热点新闻。该工具需要 'sources' 参数，指定要获取热点新闻的平台 ID 列表。

   平台 ID 列表:

   • 1: 知乎热榜 (Zhihu Hot List)
   • 2: 36氪热榜 (36Kr Hot List)
   • 3: 百度热点 (Baidu Hot Discussion)
   • 4: B站热榜 (Bilibili Hot List)
   • 5: 微博热搜 (Weibo Hot Search)
   • 6: 抖音热点 (Douyin Hot List)
   • 7: 虎扑热榜 (Hupu Hot List)
   • 8: 豆瓣热榜 (Douban Hot List)
   • 9: IT新闻 (IT News)

   调用示例:

   • 获取百度热点: 'get_hot_news([3])'
   • 获取知乎热榜、百度热点和虎扑热榜: 'get_hot_news([1, 3, 7])'
   • 获取知乎、36氪、百度和B站热榜: 'get_hot_news([1, 2, 3, 4])'

3. 接收热点新闻: 服务器将返回包含热点新闻的 JSON-RPC 响应。内容以 Markdown 格式组织，方便 LLM 理解和使用。

通过 HotNews MCP Server，您的 LLM 应用可以轻松获取最新的中文互联网热点资讯，提升内容的时效性和相关性。