home / mcp / mcp gnews server

MCP Gnews Server

Provides an MCP server that enables clients to search for related news on the internet.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "algonacci-mcp-gnews": {
      "command": "uv",
      "args": [
        "--directory",
        "%USERPROFILE%/Documents/GitHub/mcp-gnews",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

This MCP server enables clients to search for related news on the internet by exposing a dedicated search channel through the MCP runtime. It is useful when you want to programmatically query current or related news from an MCP client and integrate results into your workflows or applications.

How to use

Start the gnews MCP server using the runtime as configured. Your client can interact with this server to request related news results. When the server is running, you can issue search requests from your MCP client and receive news results back for display, filtering, or aggregation.

How to install

Prerequisites you need before starting: a Python script ready to run and the MCP runtime you use to execute stdio servers (for example, the uv runtime). Ensure the Python script main.py and the project directory are placed as shown in the runtime configuration.

Create the project directory (as referenced in the configuration):

mkdir -p "%USERPROFILE%/Documents/GitHub/mcp-gnews"

Place the server files in the directory and prepare to run with the MCP runtime. Then start the server using the exact runtime command shown in the configuration snippet.

uv --directory "%USERPROFILE%/Documents/GitHub/mcp-gnews" \
   run \
   python main.py

Additional sections

Configuration for the MCP client to load this server is provided by the following JSON snippet. This defines a single stdio MCP server named gnews_search that runs a Python script via the uv runtime.

{
  "mcpServers": {
    "gnews_search": {
      "command": "uv",
      "args": [
        "--directory",
        "%USERPROFILE%/Documents/GitHub/mcp-gnews",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

Available tools

search_news

Search related news on the internet and return results to MCP clients.