Rss News Analyzer MCP

RSS新闻分析器MCP服务器

用于RSS新闻分析和趋势检测的模型上下文协议（MCP）服务器。此服务器提供用于监视RSS提要、分析新闻趋势、检测内容峰值以及从新闻文章中生成见解的工具。

特性

• RSS源管理：配置和监视多个RSS源
• 谷歌提醒支持：专门解析谷歌快讯RSS源
• 趋势分析：从新闻文章中检测热门话题和关键字
• 棘波检测：识别主题覆盖范围的突然增加
• 公司介绍：跟踪新闻文章中提及的公司
• 关键词分析：从文章中提取并分析相关关键词
• 缓存：支持TTL的高效缓存系统
• 调试工具：全面的调试和分析工具

安装

为了发展

1. 克隆存储库：

git clone https://github.com/Joopsnijder/rss-news-analyzer-mcp.git
cd rss-news-analyzer-mcp

1. 安装依赖项：

uv sync

1. 通过编辑配置RSS源 rss_feeds_config.json

1. 可选：通过复制设置环境变量 .env.example 向 .env

适用于克劳德桌面

要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop配置文件中：

配置文件的位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "RSS News Analyzer": {
      "command": "/Users/yourusername/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/rss-news-analyzer-mcp",
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/rss-news-analyzer-mcp/server.py"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "OPENAI_ORGANIZATION_ID": "your-openai-org-id-here"
      }
    }
  }
}

重要提示：

• 替换 /Users/yourusername/.local/bin/uv 使用您的实际紫外线安装路径
• 替换 /path/to/rss-news-analyzer-mcp 带有克隆存储库的实际路径
• 将您的OpenAI API凭据添加到 env 如果您想要高级分析功能，请参阅部分

要查找您的紫外线路径：

which uv

添加此配置后：

1. 重新启动克劳德桌面
2. RSS新闻分析器工具将在您的Claude Desktop对话中可用
3. 你可以开始使用以下工具 get_rss_feeds(), analyze_news_trends()等等。

配置

RSS源配置

编辑 rss_feeds_config.json 要配置RSS源，请执行以下操作：

{
  "feeds": [
    {
      "id": "google_alerts_ai",
      "name": "Google Alerts - AI",
      "url": "https://www.google.com/alerts/feeds/YOUR_FEED_ID/YOUR_FEED_TOKEN",
      "type": "google_alerts",
      "keywords": ["AI", "artificial intelligence", "machine learning"],
      "update_frequency": "1h",
      "enabled": true,
      "analysis_settings": {
        "track_sentiment": true,
        "extract_companies": true,
        "detect_trends": true
      }
    }
  ]
}

饲料类型

• 谷歌警报：具有专门解析功能的Google Alerts RSS提要
• 标准_rss：标准RSS/Atom源
• 原子：原子馈送
• 定制：自定义提要格式

环境变量

可选环境变量（创建 .env 文件）：

# OpenAI API (optional - for advanced analysis)
OPENAI_API_KEY=your_api_key
OPENAI_ORGANIZATION_ID=your_org_id

# Logging
LOG_LEVEL=INFO

# Cache settings
CACHE_TTL_HOURS=1

运行服务器

发展模式

uv run mcp dev server.py

生产模式

uv run server.py

使用MCP检查器

npx @modelcontextprotocol/inspector uv run server.py

可用工具

饲料管理

• configure_rss_feeds()：获取配置和管理说明
• get_rss_feeds(enabled_only=True)：列出已配置的订阅源
• fetch_rss_feed(feed_id, force_refresh=False)：获取特定提要
• refresh_all_feeds()：刷新所有已启用的订阅源
• get_feed_statistics(feed_id=None)：获取提要统计信息

新闻分析

• analyze_news_trends(hours=24, min_mentions=3)：分析热门话题
• get_trending_keywords(hours=24)：获取热门关键词
• detect_news_spikes(hours=24, comparison_hours=168)：检测覆盖率峰值
• get_news_summary(hours=24)：获取全面的新闻摘要
• suggest_timely_topics(hours=24)：为内容创建提供及时的主题建议

搜索和发现

• search_news_articles(query, feed_id=None, hours=168)：搜索文章
• get_company_mentions(hours=24)：分析公司提及

调试

• debug_rss_feed(feed_id)：调试提要连接和解析
• analyze_feed_keywords(feed_id, hours=168)：分析关键字匹配
• get_all_feed_articles(feed_id, limit=20)：从订阅源获取所有文章

使用示例

基本趋势分析

# Get trending topics from last 24 hours
trends = analyze_news_trends(hours=24, min_mentions=3)

公司监控

# Track company mentions in recent news
companies = get_company_mentions(hours=24)

内容建议

# Get timely topic suggestions
suggestions = suggest_timely_topics(hours=24)

进料调试

# Debug feed issues
debug_info = debug_rss_feed("google_alerts_ai")

谷歌警报设置

1. 在以下位置创建谷歌提醒 google.com/alerts
2. 将传递设置为“RSS提要”
3. 复制RSS源URL
4. 添加到您的 rss_feeds_config.json 键入“google_alerts”

建筑

src/
├── analytics/          # News analysis and trend detection
│   └── news_analyzer.py
├── config/            # RSS feed configuration management
│   └── rss_config.py
├── content/           # RSS feed processing
│   └── rss_feed_service.py
├── tools/             # MCP tools registration
│   └── rss_tools.py
└── utils/             # Utility functions
    ├── cache_manager.py
    └── rss_utils.py

关键组件

• 新闻分析器：趋势检测、尖峰分析、主题建议
• RSS源服务：提要处理、缓存、文章提取
• RSS配置管理器：饲料配置和管理
• RSS工具：Feed解析、Google Alerts支持、关键字提取
• 缓存管理器：基于TTL的缓存以提高性能

缓存

服务器使用智能缓存系统：

• 缓存饲料数据1小时（可配置）
• 缓存存储在项目根目录中的文件
• 基于TTL的缓存自动失效
• 提供强制刷新选项

错误处理

• 进料故障的全面错误处理
• 当饲料不可用时，性能会下降
• 用于故障排除的详细调试信息
• 用于监控和调试的日志记录

贡献

1. 分叉存储库
2. 创建要素分支
3. 添加新功能的测试
4. 确保所有测试通过
5. 提交拉取请求

测试

运行测试套件：

uv run pytest tests/

运行特定测试文件：

uv run pytest tests/test_server.py

许可证

\[在此处添加您的许可证信息\]

支持

对于问题和疑问：

• 检查调试工具(debug_rss_feed, analyze_feed_keywords)
• 查看日志中的错误消息
• 验证RSS源URL是否可访问
• 检查中的配置格式 rss_feeds_config.json

更新日志

v0.1.0

• 初始版本
• RSS源管理和分析
• 谷歌警报支持
• 趋势检测和尖峰分析
• 公司提及跟踪
• 全面的调试工具