Headline Vibes Analysis MCP Server

Headline Vibes — EventRegistry MCP 服务

Headline Vibes 是一个 Model Context Protocol 服务，用于分析从 EventRegistry（newsapi.ai）获取的美国新闻标题中的投资者情绪。它支持每日和每月分析模式，生成带有诊断信息的结构化输出，并可通过 stdio 或 HTTP 运行（可部署到 Railway）。

功能

• 精选美国新闻机构报道，并按投资者相关性进行筛选
• 双重情绪评分（总体 + 投资者），统一换算为 0–10 分
• 政治倾向细分、来源分布和抽样诊断
• 支持解析每日请求中的自然语言日期（“昨天”、“上周五”等）
• 生成兼容 MCP structuredContent 的结构化 JSON 输出
• 内置 token 预算管理和速率限制遥测

前提条件

• Node.js v18+（推荐使用 LTS 版本）
• EventRegistry API 密钥（https://newsapi.ai）

设置

1. 安装依赖并构建：

   npm install
   npm run build
   

2. 配置环境变量（stdio 示例）：

   {
     "mcpServers": {
       "headline-vibes": {
         "command": "node",
         "args": ["/absolute/path/headline-vibes/build/index.mjs"],
         "env": {
           "NEWS_API_KEY": "your-eventregistry-key",
           "TRANSPORT": "stdio"
         }
       }
     }
   }
   

3. 对于 HTTP（Railway）部署，请设置 TRANSPORT=http、HOST=0.0.0.0、PORT=<port>，并可选设置 ALLOWED_HOSTS/ALLOWED_ORIGINS。

可用工具

analyze_headlines

单日情绪快照。参数：{ "input": string }。

• 接受自然语言或 YYYY-MM-DD。
• 返回投资者/总体评分、摘要、分布、标题样例和诊断信息。

analyze_monthly_headlines

汇总两个指定月份之间的数据。参数：{ "startMonth": "YYYY-MM", "endMonth": "YYYY-MM" }。

• 输出每月的政治情绪、标题数量以及 token/抽样诊断信息。

用于生成结构化结果的 JSON 架构位于 src/schemas/headlines.ts。

开发与测试

• 监视模式：npm run watch
• Stdio 运行：NEWS_API_KEY=... npm run start:stdio
• HTTP 运行：TRANSPORT=http HOST=0.0.0.0 PORT=8787 NEWS_API_KEY=... npm run start:http
• 检查 EventRegistry 连通性：node ./build/scripts/smoke.mjs 2025-02-01
• 单元测试（Vitest）：npm test

Railway 部署

1. 设置环境变量（TRANSPORT、HOST、PORT、NEWS_API_KEY，以及可选的 ALLOWED_HOSTS、ALLOWED_ORIGINS、LOG_LEVEL）。
2. 在本地执行一次构建（npm run build），或通过 Railway 的构建步骤构建。
3. 使用 npm run start 启动。
4. 健康检查：GET /healthz 返回 200 ok。

完整部署指南见 docs/railway.md；Claude Desktop 集成步骤见 docs/claude-desktop.md。

许可证

MIT