JinDaGe - headline-vibes MCP Details

article

README

🚀 头条 vibes 分析 MCP 服务器

本项目是一个 Model Context Protocol 服务器，用于分析美国主要新闻出版物头条新闻中的情感。它提供了基于日期的标准接口和自然语言日期解析功能，极大地方便了用户的使用。

🚀 快速开始

本服务器可帮助你轻松分析美国主要新闻出版物头条新闻中的情感。你只需按照以下步骤操作，即可快速上手。

✨ 主要特性

批量分析：每请求最多可分析100条头条新闻。
来源均衡：头条新闻在主要美国新闻来源之间均匀分布。
情感评分：情感评分范围为 0 - 10 分（0 = 最负面，10 = 最正面）。
日期解析：支持自然语言日期解析（例如，“昨天”，“上周五”）。
来源信息：提供详细的来源分布信息。
示例展示：结果中包含示例头条新闻。

📦 安装指南

先决条件

Node.js v16 或更高版本
NewsAPI 密钥（获取方式：https://newsapi.org）

安装步骤

克隆仓库：

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

安装依赖项：

npm install

构建服务器：

npm run build

在您的 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 许可证。

headline-vibes