Headline Vibes Analysis MCP Server

View original on GitHub 

A Model Context Protocol server that analyzes sentiment in news headlines from major US publications. The server provides both a standard date-based interface and natural language date parsing for easier use.

Features

• Analyzes up to 100 headlines per request
• Even distribution of headlines across major US news sources
• Sentiment scoring on a 0-10 scale (0 = most negative, 10 = most positive)
• Natural language date parsing (e.g., “yesterday”, “last Friday”)
• Detailed source distribution information
• Sample headlines included in results

Prerequisites

• Node.js v16 or higher
• NewsAPI key (get one at https://newsapi.org )

Installation

1. Clone the repository:

git clone https://github.com/fred-em/headline-vibes.git
cd headline-vibes

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Configure your NewsAPI key in your MCP settings file:

{
  "mcpServers": {
    "headline-vibes": {
      "command": "node",
      "args": ["/path/to/headline-vibes/build/index.mjs"],
      "env": {
        "NEWS_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

analyze_headlines

Analyze sentiment using natural language date input or specific dates.

Example usage:

// Using natural language
{
  "name": "analyze_headlines",
  "arguments": {
    "input": "yesterday"
  }
}
 
// Or using specific dates
{
  "name": "analyze_headlines",
  "arguments": {
    "input": "2025-02-11"
  }
}

Input examples:

• “last Friday”
• “3 days ago”
• “March 10th”
• “two weeks ago”
• “2025-02-11” (YYYY-MM-DD format also supported)

Response Format

The tool returns results in the following format:

{
  "score": "6.50",              // Normalized sentiment score (0-10)
  "synopsis": "Overall positive sentiment in today's headlines",
  "headlines_analyzed": 100,    // Number of headlines analyzed
  "sources_analyzed": 12,       // Number of unique sources
  "source_distribution": {      // Distribution of headlines by source
    "Reuters": 10,
    "Associated Press": 8,
    "CNN": 9,
    // ... etc
  },
  "sample_headlines": [         // Up to 5 sample headlines
    "Example headline 1",
    "Example headline 2",
    // ... etc
  ]
}

News Sources

The server pulls headlines from major US news sources including:

• Associated Press
• Reuters
• CNN
• Fox News
• NBC News
• ABC News
• Wall Street Journal
• Washington Post
• USA Today
• Bloomberg
• Business Insider
• Time

Error Handling

The server provides clear error messages for common issues:

• Invalid date formats
• Unparseable natural language queries
• No headlines found for the specified date
• API errors from NewsAPI

Development

To run the server in watch mode during development:

npm run watch

License

MIT