Headline Vibes

🚀 頭條 vibes 分析 MCP 服務器

本項目是一個 Model Context Protocol 服務器，用於分析美國主要新聞出版物頭條新聞中的情感。它提供了基於日期的標準接口和自然語言日期解析功能，極大地方便了用戶的使用。

🚀 快速開始

本服務器可幫助你輕鬆分析美國主要新聞出版物頭條新聞中的情感。你只需按照以下步驟操作，即可快速上手。

✨ 主要特性

• 批量分析：每請求最多可分析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”（三天前）
• “March 10th”（3月10日）
• “two weeks ago”（兩週前）
• “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 許可證。