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