JG

jbenton/guardian-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

20 stars 2 forks 品質 64 トレンド 10MIT

LLMをガーディアンのアーカイブに接続するMCP

概要

LLM を The Guardian のアーカイブ (1999 年以降) に接続する MCP サーバーで、すべての記事の完全なテキストを含む - それらの 1.9 万以上。 リアルタイムの見出し、ジャーナリズムの分析、および歴史的研究に有用。 [https://open-platform.theguardian.com/access/] を 1 つ取得できます。 Guardianは、最大1コール/秒、500コール/日を含む、アーカイブの非商用使用のための寛大なAPIアクセスを提供しています。 (完全な利用規約を参照してください。) 商用利用には異なるライセンスが必要です。 Guardian search:記事のアーカイブを検索する API 応答のサイズを決定し、パフォーマンスを最適化するために、thedetail level パラメータを使用します。最小限(ヘッドラインのみ)、標準(ヘッドライン、要約、メタデータ)、またはフル(全記事テキストを含むすべてのコンテンツ)。 Guardian get article:個々の記事を取得 Guardian search tags: Guardianの50,000以上のハンドアサインタグで検索 Guardian find 関連:記事に似ている記事(共有タグ経由)

概要(AI 翻訳)

LLM を The Guardian のアーカイブ (1999 年以降) に接続する MCP サーバーで、すべての記事の完全なテキストを含む - それらの 1.9 万以上。 リアルタイムの見出し、ジャーナリズムの分析、および歴史的研究に有用。

インストール

** Guardian Open Platform API キーが必要です。** [https://open-platform.theguardian.com/access/] を 1 つ取得できます。

Guardianは、最大1コール/秒、500コール/日を含む、アーカイブの非商用使用のための寛大なAPIアクセスを提供しています。 (完全な利用規約を参照してください。) 商用利用には異なるライセンスが必要です。

インストールするには:

Sample MCP の顧客構成:

ツール参照

[guardian_search:記事のアーカイブを検索する

API レスポンスのサイズを決定し、パフォーマンスを最適化するために、[[minimal] パラメータ、 standard (見出し、要約、メタデータ)、 [[full (全文を含む) を使用します。

[[guardian_get_article]:個々の記事を取得

[guardian_search_tags: ガーディアンの 50,000 以上のハンドアサインタグで検索

[guardian_find_related:記事に似ている記事(共有タグ経由)

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Guardian MCP Server

An MCP server that connects an LLM to the archives (since 1999) of The Guardian, including the full text of all articles — more than 1.9 million of them. Useful for real-time headlines, journalism analysis, and historical research.

Installation

A Guardian Open Platform API key is required. You can get one here: https://open-platform.theguardian.com/access/

The Guardian offers generous API access for non-commercial use of the archives, including up to 1 call/second and 500 calls/day. (See the full Terms & Conditions. Commercial use requires a different license.)

To install:

npx guardian-mcp-server

Sample MCP client configuration:

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

Tool reference

guardian_search: search the archive for articles

Use thedetail_level parameter to determine the size of the API response and optimize performance: minimal (headlines only), standard (headlines, summaries, and metadata), or full (all content, including full article text).

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

guardian_get_article: retrieve individual articles

{
  "article_id": "https://www.theguardian.com/politics/2024/dec/01/example", 
  "truncate": false  // full content by default
}

guardian_search_tags: search through The Guardian’s 50,000-plus hand-assigned tags

guardian_find_related: find articles similar to an article (via shared tags)

guardian_get_article_tags: returns tags assigned to any article

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

guardian_lookback: historical search by date

guardian_content_timeline: analyze Guardian content on a particular topic over a defined period

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

guardian_top_stories_by_date: estimates editorial importance; The Guardian’s API doesn’t natively return data to differentiate between Page 1 stories and inside briefs, and this tries to hack a ranking together

{
  "date": "2016-06-24",  // Brexit referendum day
  "story_count": 5
}

guardian_topic_trends: compare multiple topics over time with correlation analysis and competitive rankings

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

guardian_author_profile: generate profiles of Guardian journalists and what they cover

{
GitHub で README 全文を見る

インストール

npx guardian-mcp-server
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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