Guardian MCP Server

🚀 Guardian MCP Server

The Guardian の1999年以降のアーカイブ（記事全文を含む190万本以上）にLLMを接続するMCPサーバーです。リアルタイムの見出し、ジャーナリズム分析、および歴史的研究に役立ちます。

🚀 クイックスタート

このサーバーは、The Guardian のアーカイブデータにアクセスできるようにするためのものです。以下の手順でセットアップして利用できます。

✨ 主な機能

• アーカイブ内の記事を検索する機能 (guardian_search)
• 個々の記事を取得する機能 (guardian_get_article)
• ガーディアンの5万以上の手動で割り当てられたタグを検索する機能 (guardian_search_tags)
• 記事に類似した記事を見つける機能 (guardian_find_related)
• 記事に割り当てられたタグを取得する機能 (guardian_get_article_tags)
• 日付での過去の記事を検索する機能 (guardian_lookback)
• 特定のトピックに関するガーディアンのコンテンツを期間を指定して分析する機能 (guardian_content_timeline)
• 編集上の重要度を推定する機能 (guardian_top_stories_by_date)
• 複数のトピックを時間をかけて比較する機能 (guardian_topic_trends)
• ガーディアンのジャーナリストのプロフィールを生成する機能 (guardian_author_profile)
• ロングリードシリーズを検索する機能 (guardian_longread)
• 特定のセクションの最近の記事を閲覧する機能 (guardian_browse_section)
• 利用可能なすべてのガーディアンのセクションを取得する機能 (guardian_get_sections)
• 単語数で記事をフィルタリングする機能 (guardian_search_by_length)
• 筆者によって記事を検索する機能 (guardian_search_by_author)
• 興味に基づいたロングリードの推薦を取得する機能 (guardian_recommend_longreads)

📦 インストール

⚠️ 重要提示

Guardian Open Platform のAPIキーが必要です。ここから取得できます：https://open-platform.theguardian.com/access/

ガーディアンは、アーカイブの非商用利用に対して寛大なAPIアクセスを提供しています。1秒あたり最大1回の呼び出しと1日あたり500回の呼び出しが許可されています。（詳細な利用規約を参照してください。商用利用には別のライセンスが必要です。）

インストール方法：

npx guardian-mcp-server

サンプルのMCPクライアント設定：

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

💻 使用例

基本的な使用法

guardian_search を使った記事検索

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

detail_level パラメータを使用して、API応答のサイズを決定し、パフォーマンスを最適化できます。minimal（見出しのみ）、standard（見出し、要約、およびメタデータ）、または full（記事全文を含むすべてのコンテンツ）が選択可能です。

guardian_get_article を使った個別記事の取得

{
  "article_id": "https://www.theguardian.com/politics/2024/dec/01/example", 
  "truncate": false  // デフォルトで全内容を取得
}

高度な使用法

guardian_search_tags を使ったタグ検索

{
  // タグ検索の具体的なクエリをここに記述
}

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 を使った編集重要度の推定

{
  "date": "2016-06-24",  //  Brexit国民投票の日
  "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ライセンスです。