Guardian News MCP Server

Guardian News MCP Server

Enables users to search for the latest news articles from The Guardian using keywords and check service status. Provides access to Guardian's news content through their API with configurable result limits.

Category
Visit Server

README

Guardian News MCP Server

The Guardian API를 사용하여 최신 뉴스를 검색할 수 있는 MCP (Model Context Protocol) 서버입니다.

기능

  • 뉴스 검색: 특정 키워드로 Guardian API에서 최신 뉴스 검색
  • 서비스 상태 확인: API 키 설정 상태 및 서비스 상태 확인
  • 도구 정의 제공: MCP 도구 정의를 JSON 형식으로 제공

설치 및 설정

1. 의존성 설치

pip install -r requirements.txt

또는 uv를 사용하는 경우:

uv sync

2. 환경 변수 설정

.env 파일을 생성하고 Guardian API 키를 설정하세요:

GUARDIAN_API_KEY=your_guardian_api_key_here

Guardian API 키는 The Guardian Open Platform에서 무료로 발급받을 수 있습니다.

3. 서버 실행

python -m src.main

사용 가능한 도구

1. health

서비스 상태를 확인합니다.

매개변수: 없음

반환값:

{
  "status": "ok",
  "environment": {
    "guardian_api_key": "설정됨",
    "api_key_preview": "e8bf1e48-7..."
  }
}

2. search_news_tool

특정 키워드로 뉴스를 검색합니다.

매개변수:

  • query (필수): 검색할 뉴스 키워드
  • page_size (선택): 가져올 기사의 수 (기본값: 5, 최대: 50)

반환값:

{
  "articles": [
    {
      "headline": "뉴스 제목",
      "summary": "뉴스 요약",
      "url": "https://www.theguardian.com/..."
    }
  ]
}

3. get_tool_definitions

MCP 도구 정의를 JSON 형식으로 제공합니다.

매개변수: 없음

프로젝트 구조

mcp-guardian-news/
├── src/
│   ├── main.py          # MCP 서버 메인 파일
│   └── tools.py         # Guardian API 호출 도구
├── requirements.txt     # Python 의존성
├── pyproject.toml       # 프로젝트 설정
├── tool_definitions.json # MCP 도구 정의
├── .gitignore          # Git 무시 파일
└── README.md           # 프로젝트 문서

기술 스택

  • FastMCP: MCP 서버 구현
  • Pydantic: 데이터 검증 및 직렬화
  • Requests: HTTP API 호출
  • Python-dotenv: 환경 변수 관리

라이선스

MIT License

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured