Guardian MCP Server

🚀 守护者MCP服务器

这是一个MCP服务器，它将大语言模型（LLM）与《卫报》自1999年以来的存档连接起来，其中包含超过190万篇文章的全文内容。该服务器可用于获取实时头条新闻、进行新闻分析以及开展历史研究。

🚀 快速开始

本服务器可将大语言模型与《卫报》的海量文章存档相连，为用户提供丰富的新闻资源，满足实时资讯获取、新闻分析和历史研究等多方面需求。

✨ 主要特性

• 连接大语言模型与《卫报》自1999年起的文章存档，涵盖超190万篇文章全文。
• 适用于实时头条新闻获取、新闻分析和历史研究。
• 提供多种API接口，可进行文章搜索、单篇文章获取、标签搜索等操作。

📦 安装指南

需要一个《卫报》开放平台的API密钥。你可以在此处获取：https://open-platform.theguardian.com/access/

《卫报》为存档的非商业使用提供了慷慨的API访问权限，包括每秒1次调用和每天500次调用。（详见完整的条款与条件。商业使用需要不同的许可证。）

安装命令如下：

npx guardian-mcp-server

MCP客户端配置示例：

{
  "mcpServers": {
    "guardian": {
      "command": "npx",
      "args": ["guardian-mcp-server"],
      "env": {
        "GUARDIAN_API_KEY": "your-key-here"
      }
    }
  }
}

💻 使用示例

基础用法

以下是使用不同API接口的示例：

guardian_search：搜索存档文章

使用detail_level参数来确定API响应的大小并优化性能：minimal（仅标题）、standard（标题、摘要和元数据）或full（所有内容，包括文章全文）。

{
  "query": "climate change",
  "section": "environment", 
  "detail_level": "minimal",
  "from_date": "2024-01-01",
  "order_by": "newest"
}

guardian_get_article：获取单篇文章

{
  "article_id": "https://www.theguardian.com/politics/2024/dec/01/example", 
  "truncate": false  // 默认返回完整内容
}

guardian_search_tags：搜索《卫报》的5万多个手动分配的标签

guardian_find_related：查找与某篇文章相似的文章（通过共享标签）

guardian_get_article_tags：返回分配给任何文章的标签

{
  "article_id": "politics/2024/example"
}

guardian_lookback：按日期进行历史搜索

guardian_content_timeline：分析特定时间段内《卫报》关于特定主题的内容

{
  "query": "artificial intelligence",
  "from_date": "2024-01-01",
  "to_date": "2024-06-30", 
  "interval": "month"
}

guardian_top_stories_by_date：估算编辑重要性；《卫报》的API本身不会返回区分头版故事和内页简报的数据，此接口试图综合得出一个排名

{
  "date": "2016-06-24",  // 英国脱欧公投日
  "story_count": 5
}

guardian_topic_trends：通过相关性分析和竞争排名比较多个主题随时间的变化

{
  "topics": ["artificial intelligence", "climate change", "brexit"],
  "from_date": "2023-01-01",
  "to_date": "2024-12-31",
  "interval": "quarter"
}

guardian_author_profile：生成《卫报》记者的简介以及他们报道的领域

{
  "author": "George Monbiot",
  "analysis_period": "2024"
}

guardian_longread：搜索《卫报》的长篇特写系列

guardian_browse_section：浏览特定板块的近期文章

guardian_get_sections：获取《卫报》的所有可用板块

guardian_search_by_length：按字数过滤文章

guardian_search_by_author：按作者搜索文章

guardian_recommend_longreads：根据用户兴趣获取个性化的长篇特写推荐

{
  "count": 3,
  "context": "I'm researching technology, especially AI",
  "topic_preference": "digital culture"
}

📄 许可证

本项目采用MIT许可证。