标题氛围——EventRegistry MCP服务器
Headline Vibes 是一个模型上下文协议服务器，它分析从 EventRegistry（newsapi.ai）获取的美国新闻头条中的投资者情绪。它支持每日和每月分析模式，生成带有诊断信息的结构化输出，并且可以通过标准输入输出（stdio）或HTTP（已适配Railway部署）运行。
特点/功能
- 精选美国新闻编辑室报道，附带投资者相关性过滤
- 双重情感得分（总体+投资者）按0-10分进行标准化
- 政治倾向性分解、来源分布及抽样诊断
- 日常请求中的自然语言日期解析
"yesterday"，"last Friday"等） - 与MCP兼容的结构化JSON输出
structuredContent - 内置的令牌预算管理和速率限制遥测功能
先决条件
- Node.js v18+（建议使用长期支持版本）
- 事件注册表API密钥（https://newsapi.ai）
设置
- 安装依赖项并构建：
npm install
npm run build- 配置环境变量（stdio 示例）：
{
"mcpServers": {
"headline-vibes": {
"command": "node",
"args": ["/absolute/path/headline-vibes/build/index.mjs"],
"env": {
"NEWS_API_KEY": "your-eventregistry-key",
"TRANSPORT": "stdio"
}
}
}
}- 对于HTTP（铁路）部署，请设置
TRANSPORT=http，HOST=0.0.0.0， `PORT=
，以及可选地 ALLOWED_HOSTS/ALLOWED_ORIGINS`。
可用工具
analyze_headlines
单日每日情绪快照。参数： { "input": string }。
- 接受自然语言或
YYYY-MM-DD。 - 返回投资者/通用评分、概要、分布、样本标题和诊断信息。
analyze_monthly_headlines
两个月之间的月度汇总。参数： { "startMonth": "YYYY-MM", "endMonth": "YYYY-MM" }。
- 每月输出政治情绪分析、头条新闻数量统计以及标记/采样诊断结果。
为结构化结果提供支持的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 - 检查Smoke check EventRegistry的连接性：
node ./build/scripts/smoke.mjs 2025-02-01 - 单元测试（Vitest）：
npm test
铁路部署
- 设置环境变量（
TRANSPORT，HOST，PORT，NEWS_API_KEY，可选ALLOWED_HOSTS，ALLOWED_ORIGINS，LOG_LEVEL）。 - 在本地构建一次（
npm run build) 或通过铁路的构建步骤。 - 以……开始
npm run start。 - 健康检查：
GET /healthz回报；收益200 ok。
见 docs/railway.md 以获取完整的策略手册。
许可证
麻省理工学院（MIT）
