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許可證。