AI导哈

新闻聚合服务

一个简单快速的MCP服务器，提供来自The Blue Report的顶级新闻故事，支持按小时、天和周获取结构化新闻数据。

  • by lizTheDeveloper
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 lizthedeveloper/bluesky_bluereport

使用说明

蓝色报告MCP服务器

一个简单、快速的MCP服务器，可访问以下媒体的热门新闻报道 蓝色报告 -Bluesky的顶部链接，每小时更新一次。

特性

  • 三个时段：获取每小时、每天或每周的新闻
  • 结构化输出：干净、结构化的数据，包括标题、摘要和网址
  • 快速性能：响应时间不超过2秒，开销最小
  • 实时数据：从The Blue Report网站获取实时数据
  • 错误处理：当网站不可用时，优雅的回退

先决条件

  • Python 3.11或更高版本
  • 紫外线 包管理器

安装

  1. 克隆存储库:

    git clone <repository-url>
cd bluesky_bluereport

  2. 使用uv安装依赖项:

    uv sync

用法

发展模式

使用MCP检查器测试服务器：

uv run mcp dev server.py

这将在以下时间启动MCP检查器http://127.0.0.1:6274在那里你可以测试工具。

Claude桌面集成

在Claude Desktop中安装服务器：

uv run mcp install server.py

直接执行

直接运行服务器：

uv run python server.py

测试

运行测试脚本以验证功能：

uv run python test_server.py

可用工具

1. get_hourly_news()

获取过去一小时《蓝色报道》的头条新闻。

2. get_daily_news()

获取过去24小时《蓝色报告》的头条新闻。

3. get_weekly_news()

获取过去7天《蓝色报告》的头条新闻。

数据结构

每个工具返回一个 NewsResponse 与：

{
    "stories": [
        {
            "headline": "Story headline",
            "summary": "Story summary with source and engagement",
            "published_at": "2025-01-27T10:00:00",
            "source": "The Blue Report",
            "url": "https://example.com/story",
            "category": "Bluesky Trending"
        }
    ],
    "count": 10,
    "time_period": "daily",
    "retrieved_at": "2025-01-27T10:00:00"
}

建筑

  • FastMCP服务器：使用FastMCP实现主服务器
  • 蓝色报告客户端：用于网站抓取的HTTP客户端
  • 数据模型：结构化输出的Pydantic模型
  • HTML解析器：BeautifulSoup用于解析《蓝色报告》网站
  • 错误处理：优雅的后退和伐木

演出

  • 服务器启动：<5秒
  • 工具响应：<2秒
  • 内存使用：<50MB
  • 依赖项：5个包裹

依赖项

管理者 uv 在……里面 pyproject.toml:

  • mcp[cli]>=1.12.3 -MCP-SDK
  • httpx>=0.28.1 -HTTP客户端
  • pydantic>=2.11.7 -数据验证
  • beautifulsoup4>=4.13.4 -HTML解析
  • requests>=2.31.0 -HTTP请求

发展

项目结构

bluesky_bluereport/
├── plans/
│   ├── requirements.md
│   └── plan.md
├── devlog/
│   └── mcp_server_development.md
├── src/
│   ├── __init__.py
│   ├── server.py
│   ├── blue_report.py
│   └── models.py
├── pyproject.toml
├── server.py
├── test_server.py
└── README.md

开发命令

# Install dependencies
uv sync

# Run tests
uv run python test_server.py

# Start MCP Inspector
uv run mcp dev server.py

# Install in Claude Desktop
uv run mcp install server.py

# Add new dependency
uv add package-name

# Add dev dependency
uv add --dev package-name

添加新功能

  1. 更新中的要求 plans/requirements.md
  2. 实施变更 src/ 模块
  3. 测试用 uv run python test_server.py
  4. 更新开发日志 devlog/
  5. 使用MCP检查员进行测试

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP