MCP Hot News Server

A modern multi-platform hot news aggregation server based on FastMCP providing real-time topics from major platforms.

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wudalu-mcp-hot-news-server": {
      "command": "mcp-hot-news",
      "args": [],
      "env": {
        "MCP_CACHE_TTL": "3600",
        "MCP_LOG_LEVEL": "INFO",
        "MCP_REQUEST_TIMEOUT": "10"
      }
    }
  }
}

You can run and consume the MCP Hot News Server to aggregate real-time hot topics from multiple platforms. It exposes a standard MCP interface built on FastMCP, supports asynchronous data collection, and can fallback to simulated data if a platform API is unavailable. This makes it ideal for AI agents, content creation, and cross-platform trend analysis.

How to use

Start the MCP server in STDIO mode to run locally and listen for MCP clients. Then use an MCP client to request hot news from specific platforms, pull aggregated results, or perform trend analyses. The server is designed to be used as a data source for AI agents, content workflows, and monitoring tools.

How to install

Prerequisites: you need Python and pip installed. The server is published as a Python package.

pip install mcp-hot-news

Additional sections

Configuration and runtime behavior are controlled via environment variables and optional provider customization. The server supports a cache TTL, request timeouts, and logging level settings.

# Example: customize the default cache TTL in code
from mcp_hot_news.server import HotNewsProvider
provider = HotNewsProvider()
provider.cache_manager.default_ttl = 7200  # 2 hours

Configuration

Set the following environment variables to tune performance and logging.

# Cache TTL in seconds
export MCP_CACHE_TTL=3600

# API request timeout in seconds
export MCP_REQUEST_TIMEOUT=10

# Logging level (e.g., INFO, DEBUG)
export MCP_LOG_LEVEL=INFO

Use cases

Use this MCP server to feed real-time hot news into AI agents, drive content creation with trending topics, monitor platform-level hot trends, perform cross-platform data analysis, or expose a microservice API for hot news data.

Development & Testing

If you are developing or testing, install development dependencies, run tests, and format code as part of your workflow.

pip install -e ".[dev]"
pytest
black src/ tests/
flake8 src/ tests/
mypy src/

Example MCP endpoints and tools

The server exposes a set of tools to fetch and analyze hot news data from multiple platforms.

{
  "mcpServers": {
    "hot_news": {
      "command": "mcp-hot-news",
      "args": []
    }
  }
}

Available tools

get_hot_news

Fetch hot news for a specific platform with a limit on items.

get_all_platforms_news

Retrieve hot news summaries from all supported platforms with a per-platform limit.

analyze_trends

Analyze current hotspots and keywords to reveal trends.

get_server_health

Check the health status of the MCP server.

clear_cache

Clear all cached data held by the server.