Headline Vibes Analysis MCP Server

Headline Vibes — EventRegistry MCP サーバー

Headline Vibes は、EventRegistry（newsapi.ai）から取得した米国のニュース見出しにおける投資家のセンチメントを分析する Model Context Protocol サーバーです。日次および月次の分析モードに対応し、診断情報を含む構造化出力を生成します。stdio または HTTP で実行できます（Railway に対応）。

機能

• 投資家との関連性によるフィルタリングを適用した、厳選された米国のニュースルーム報道
• 0～10 のスケールに正規化された、2 種類のセンチメントスコア（全般＋投資家）
• 政治的傾向の内訳、情報源の分布、サンプリング診断
• 日次リクエスト向けの自然言語による日付解析（"yesterday"、"last Friday" など）
• MCP の structuredContent と互換性のある構造化 JSON 出力
• トークン予算管理とレート制限のテレメトリーを内蔵

前提条件

• 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

1 日分のセンチメントスナップショットを取得します。引数：{ "input": string }。

• 自然言語または YYYY-MM-DD を受け付けます。
• 投資家／全般のスコア、要約、分布、見出しのサンプル、診断情報を返します。

analyze_monthly_headlines

2 か月間の月次集計を取得します。引数：{ "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
• 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