Headline Vibes

🚀 ヘッドラインバイブス分析 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、米国の主要なニュース出版物のヘッドラインの感情分析を行います。日付に基づく標準インターフェースと自然言語の日付解析機能を備えており、使いやすさを重視しています。

✨ 主な機能

• 1 リクエストあたり最大 100 件のヘッドラインを分析
• ヘッドラインは米国の主要なニュースソース間で均等に分布
• 感情スコアは 0 - 10 点の範囲（0 = 最もネガティブ、10 = 最もポジティブ）
• 自然言語の日付解析（例：「昨日」、「先週の金曜日」）
• 詳細なソース分布情報
• 結果にサンプルのヘッドラインを含む

📦 インストール

前提条件

• Node.js v16 以上
• NewsAPI キー（取得方法：https://newsapi.org）

インストール手順

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

3. サーバーをビルドします：

npm run build

4. MCP 設定ファイルで NewsAPI キーを設定します：

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

💻 使用例

基本的な使用法

analyze_headlines

自然言語の日付入力または特定の日付を使用して感情分析を行います。

// 自然言語を使用する場合
{
  "name": "analyze_headlines",
  "arguments": {
    "input": "yesterday"
  }
}

// 特定の日付を使用する場合
{
  "name": "analyze_headlines",
  "arguments": {
    "input": "2025-02-11"
  }
}

入力例：

• “last Friday”（先週の金曜日）
• “3 days ago”（3日前）
• “March 10th”（3月10日）
• “two weeks ago”（2週間前）
• “2025-02-11”（YYYY-MM-DD 形式もサポート）

高度な使用法

応答形式

ツールは以下の形式で結果を返します：

{
  "score": "6.50",              // 正規化された感情スコア（0 - 10）
  "synopsis": "今日のヘッドラインの全体的な雰囲気はポジティブです",
  "headlines_analyzed": 100,    // 分析されたヘッドラインの数
  "sources_analyzed": 12,       // 分析された一意のソースの数
  "source_distribution": {      // ソース別のヘッドライン分布
    "路透社": 10,
    "美联社": 8,
    "CNN": 9,
    // ... など
  },
  "sample_headlines": [         // 最大 5 件のサンプルヘッドライン
    "サンプルヘッドライン1",
    "サンプルヘッドライン2",
    // ... など
  ]
}

📚 ドキュメント

ニュースソース

このサーバーは、以下の米国の主要なニュースソースからヘッドラインを取得します：

• 美联社
• 路透社
• CNN
• フォックスニュース
• NBC ニュース
• ABC ニュース
• 《華爾街日報》
• 《ワシントンポスト》
• 《今日アメリカ》
• 《ニューヨークタイムズ》

エラー処理

以下のエラーが発生する可能性があります：

• 無効な入力：有効な日付文字列が提供されない場合、エラーメッセージが表示されます。
• API エラー：NewsAPI からデータを取得できない場合、エラーメッセージが表示されます。

開発

開発モードでサーバーを実行するには、以下のコマンドを実行します：

npm run dev

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。