MCP News Collector

Provides real-time Korean stock market news collection, AI analyses, and REST/WebSocket access for insights.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 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": {
    "whdghk1907-mcp-news-collector": {
      "command": "python",
      "args": [
        "-m",
        "src.server.main"
      ]
    }
  }
}

MCP News Collector is a server that gathers real-time stock market news, analyzes it with AI, and exposes insights through a practical MCP interface. You can run the local server to fetch the latest headlines, run sentiment and market impact analyses, and monitor news streams as it happens.

How to use

You connect to the MCP News Collector from your client and call the available tools to fetch and analyze news. Start by running the local server, then use the client to request recent news, run sentiment analysis, and monitor real-time streams. You can query for specific tickers, compare sources, and receive up-to-date insights to support your decision making.

How to install

# 1. Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 2. Install the package in editable mode
pip install -e .

# 3. Prepare configuration
cp .env.example .env
# Edit .env to configure database and API settings

# 4. Apply database migrations
alembic upgrade head

# 5. Run the MCP server
python -m src.server.main

Additional notes

The server provides a REST API and a WebSocket-based real-time monitoring system. After starting the server, you can access the API documentation and interactive docs at the local host where the server runs. Use the REST endpoints to fetch recent news, trigger sentiment and impact analyses, and enable real-time monitoring for specified topics.

Configuration and usage notes

Key features you will use include: getting recent news, analyzing sentiment, assessing market impact, detecting rumors, and monitoring news streams. Ensure your environment variables (such as database and API keys) are set in the .env file before starting the server. If you need to customize sources or analysis parameters, adjust the configuration files in the project configuration directory.

Troubleshooting tips

If the server fails to start, verify that Python 3.11+ is installed, the PostgreSQL database is accessible, and Redis is running. Review logs for migration errors or missing environment variables in the .env file. Ensure the virtual environment is activated when installing dependencies and running the server.

Available tools

get_recent_news

Fetches the most recent news articles based on a keyword, source, limit, or time window to seed analysis and monitoring.

analyze_news_sentiment

Performs sentiment analysis on provided news text or identifiers to determine bullish or bearish sentiment.

analyze_news_impact

Evaluates potential market impact of a news item for a given company and timeframe.

detect_market_rumors

Identifies and flags potential rumors in the news stream based on a threshold.

monitor_news_stream

Sets up real-time monitoring for specified topics and filters to continuously stream updates.