MCP Newsnow

🚀 MCP 新聞聚合服務器

MCP 新聞聚合服務器基於 Model Context Protocol (MCP) 構建，藉助 Newsnow API，為用戶一站式提供多平臺的熱點新聞與趨勢話題，極大提升信息獲取效率。

🚀 快速開始

你可以按照以下步驟快速開啟 MCP 新聞聚合服務器的使用之旅。

✨ 主要特性

• 多平臺熱點聚合：一站式獲取來自酷安、知乎、微博、B站、抖音、GitHub 等 14+ 平臺的熱點內容
• 中英文源名識別：支持中英文新聞源名稱，並提供模糊匹配功能
• 自定義API端點：通過環境變量或命令行參數配置 Newsnow API 端點

📦 安裝指南

方法一：從 PyPI 安裝

# 使用 pip 安裝
pip install mcp-newsnow

# 或使用 uv 安裝
uv pip install mcp-newsnow

方法二：配置 Claude Desktop

在 Claude Desktop 配置文件中添加服務器配置：

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

添加以下配置：

{
  "mcpServers": {
    "get_news": {
      "command": "uvx",
      "args": [
        "mcp-newsnow"
      ]
    }
  }
}

💻 使用示例

使用 Claude Desktop

1. 安裝並配置 Claude Desktop
2. 在配置文件中添加上述 MCP 服務器配置
3. 重啟 Claude Desktop
4. 在對話中使用新聞相關工具

使用 MCP CLI 進行開發

# 通過環境變量設置API端點
NEWS_API_URL=https://newsnow.example.com

# 運行測試
mcp test server.py

可用工具

基礎用法

以下是獲取新聞的基礎方法：

• 獲取單一源新聞 (get_newsnow)

async def get_newsnow(source: str) -> dict[str, Any] | None

從指定源獲取最新新聞。 參數：

• source：新聞源名稱 (支持中英文，例如"知乎"、"zhihu"、"B站"等) 返回：包含新聞數據的字典

高級用法

以下是獲取多源新聞的高級方法：

• 獲取多源新聞 (get_multi_news)

async def get_multi_news(sources: list[str] = None) -> dict[str, Any]

從多個源獲取最新新聞 (最多5個)。 參數：

• sources：新聞源名稱列表 返回：包含多個新聞源數據的字典

• 獲取所有源新聞 (get_all_news)

async def get_all_news() -> dict[str, Any]

獲取所有配置的新聞源數據。 返回：包含所有新聞源數據的字典

📚 詳細文檔

環境變量

支持的新聞源

• 酷安 (coolapk)
• 知乎 (zhihu)
• 微博 (weibo)
• B站 (bilibili)
• 抖音 (douyin)
• GitHub (github)

貢獻指南

歡迎提交問題和拉取請求！以下是一些可能的改進方向：

1. 增加更多新聞源的支持
2. 優化 API 性能
3. 改善錯誤處理機制
4. 添加日誌記錄功能
5. 支持更多的 MCP 協議特性

📄 許可證

項目採用 MIT License。