News API MCP Server

News API MCP Server

site icon
2025.03.29 0
Python新闻聚合内容生成内容生成
News API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过集成 News API 提供全球新闻文章的访问功能。该服务实现了标准化的接口,用于搜索新闻文章、获取头条新闻以及列出可用的新闻来源。
View on GitHub

Overview

基本能力

产品定位

News API MCP Server 是一个新闻内容聚合服务,通过标准化的接口提供全球新闻文章的访问功能。

核心功能

  • 搜索新闻文章:支持按主题搜索新闻文章,并提供高级过滤选项。
  • 获取头条新闻:按国家、类别或来源获取头条新闻。
  • 列出新闻来源:获取可用的新闻来源信息,支持按类别、语言和国家过滤。
  • 内置错误处理:包括速率限制管理、无效 API 键处理等。

适用场景

  • 新闻聚合应用
  • 内容生成工具
  • 数据分析平台

工具列表

  1. search-news:搜索新闻文章,支持多种过滤选项。
  2. get-top-headlines:获取头条新闻,支持按国家、类别或来源过滤。
  3. get-news-sources:列出可用的新闻来源,支持按类别、语言和国家过滤。

常见问题解答

  • 速率限制:News API 免费版每天限制 100 次请求。
  • 无效 API 键:确保提供有效的 News API 键。
  • 网络连接问题:检查网络连接是否正常。

使用教程

使用依赖

  • Python 3.12 或更高版本
  • httpx
  • mcp

安装教程

通过 Docker 安装

cd news-api-mcp
docker build -t mcp/news-api .

配置 claude_desktop_config.json 文件:

{
  "mcpServers": {
    "newsapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "NEWS_API_KEY",
        "mcp/news-api"
      ],
      "env": {
        "NEWS_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

通过 Smithery 安装

npx -y @smithery/cli install @berlinbra/news-api-mcp --client claude

调试方式

运行服务器:

uv run src/news_api_mcp/server.py

使用检查器运行:

npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/news-api-mcp run src/news_api_mcp/server.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。