🚀 头条 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 许可证。