MCP News API Server

MCP News API Server

site icon
2025.05.09 0
TypeScript新闻服务API 封装内容生成
MCP News API Server 是一个基于 Model Context Protocol (MCP) 的服务,它通过暴露 News API (https://newsapi.org) 的端点来搜索和获取新闻文章。该服务允许通过 MCP 协议以编程方式访问新闻数据。
View on GitHub

Overview

基本能力

产品定位

MCP News API Server 是一个用于程序化访问新闻数据的服务,通过 MCP 协议提供对 News API 的封装。

核心功能

  • 搜索新闻文章:通过关键词、来源、域名等条件搜索新闻文章。
  • 获取头条新闻:获取特定类别、语言或国家的头条新闻。
  • 错误处理:提供基于 News API 响应的错误消息。
  • 扩展性:支持通过添加新的 TypeScript 文件来扩展更多的 News API 端点。

适用场景

  • 新闻聚合应用
  • 内容管理系统
  • 数据分析平台
  • 个性化新闻推荐系统

工具列表

  • search_articles:搜索新闻文章,支持多种过滤条件。
  • get_top_headlines:获取头条新闻,支持按类别、语言和国家过滤。

常见问题解答

  • 如何获取 News API 密钥? 从 https://newsapi.org 获取 API 密钥。
  • 如何设置环境变量? 在运行服务器前设置 NEWSAPI_KEY 环境变量。

使用教程

使用依赖

  • Node.js (v18 或更高版本)
  • npm
  • News API 密钥

安装教程

  1. 克隆仓库或确保在项目目录中。
  2. 安装依赖: bash npm install
  3. 构建服务器: bash npm run build
  4. 设置 News API 密钥: bash export NEWSAPI_KEY="YOUR_API_KEY"

调试方式

  • 直接运行: bash node build/index.jsbash npm run start
  • 通过 MCP runner 运行: 配置 MCP 客户端以使用 stdio 传输运行服务器,并在 MCP runner 的设置中配置环境变量。

许可证

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