Skip to main content

Google News MCP server for fetching news articles

Project description

MCP Server Google News

A Model Context Protocol (MCP) server for fetching Google News articles with configurable language and region settings.

Available Tools

google_news_search

Search for news articles using a query.

Parameters:

  • query (string, required): Search query
  • limit (int, optional): Number of articles to fetch (default: 10)
  • hl (string, optional): Language code (default: "ja")
  • gl (string, optional): Geographic location code (optional)

google_news_topics

Get news articles by topic.

Parameters:

  • topic_id (string, optional): Topic ID (default: TOP)
  • limit (int, optional): Number of articles to fetch (default: 10)
  • hl (string, optional): Language code (default: "ja")
  • gl (string, optional): Geographic location code (optional)

Available Topics:

  • TOP: トップニュース (default)
  • NATION: 国内
  • WORLD: 国際
  • BUSINESS: ビジネス
  • TECHNOLOGY: テクノロジー
  • ENTERTAINMENT: エンタメ
  • SPORTS: スポーツ
  • SCIENCE: 科学
  • HEALTH: 健康

Language and Region Codes

Common Language Codes (hl parameter)

  • ja: Japanese (default)
  • en: English
  • zh-CN: Chinese
  • fr: French
  • de: German
  • es: Spanish
  • ko: Korean

Common Region Codes (gl parameter)

  • JP: Japan
  • US: United States
  • GB: United Kingdom
  • CN: China
  • FR: France
  • DE: Germany
  • KR: South Korea

Installation

Using uv (Recommended)

No special installation is required when using uv. You can run mcp-server-google-news directly using uvx.

Using PIP

Alternatively, you can install mcp-server-google-news using pip:

pip install mcp-server-google-news

After installation, you can run the script as follows:

mcp-server-google-news

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx
{
  "mcpServers": {
    "google-news": {
      "command": "uvx",
      "args": ["mcp-server-google-news"]
    }
  }
}

Configure for VS Code

For quick installation, use one of the one-click install buttons below...

Install with UV in VS Code

Command Line Options

You can specify the following options when running the server:

  • --sse: Enable Server-Sent Events transport (on/off)
  • --host: Server bind address (default: localhost)
  • --port: Server port number (default: 8000)
  • --log-level: Logging verbosity (debug, info, warning, error)

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_google_news-0.1.7.tar.gz (35.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_google_news-0.1.7-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_google_news-0.1.7.tar.gz.

File metadata

  • Download URL: mcp_server_google_news-0.1.7.tar.gz
  • Upload date:
  • Size: 35.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.28.1

File hashes

Hashes for mcp_server_google_news-0.1.7.tar.gz
Algorithm Hash digest
SHA256 8d21799a1ae888033ea93108b1e124d53cc116104f28da984b67dda7d85de65a
MD5 f7edb5f481838f0c69bd86e09cd55d04
BLAKE2b-256 a0a18b042f3feb70d2aa3d8b76c0078f6e542dc8ff8906fbb85d7154ac72a2ac

See more details on using hashes here.

File details

Details for the file mcp_server_google_news-0.1.7-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_google_news-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 57de5cb98fb51e7b21b9ec5dc518e888bd012cc6344c5cba9b524b06a3cfc50b
MD5 a145a991c5d016c47790c0e2c0270c1b
BLAKE2b-256 3f6abba00bb7d80647e7603e59cc26c2b06da63f347eee68fe6eebe86fad9d84

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page