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 條新聞的詳細內容"