News

Singapore News MCP Server

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chakarai1234-news_mcp": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "tool",
        "run",
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "http://127.0.0.1:8080/mcp"
      ],
      "env": {
        "MCP_PORT": "8000"
      }
    }
  }
}

You set up this MCP server to stream real-time Singapore news feeds to clients. It aggregates updates from major sources and pushes them to you or your applications as events you can subscribe to, helping you build live-news dashboards, alerts, or analytics.

How to use

To consume real-time updates, run the MCP server and connect your client to the end points exposed by the individual retrievers. You can start the main server and then run the specific retrievers to subscribe to feeds.

How to install

Prerequisites you need before starting:

Python >= 3.12
uv package manager

Installation steps

# Clone the repository
git clone <repository-url>
cd news_mcp

# Install dependencies using uv
uv sync

Running commands

Start the MCP server and optional retrievers as shown:

# Start the MCP server
uv run news_mcp

# Individual news retrievers
uv run straits     # Straits Times
uv run business    # Business Times
uv run cna         # Channel News Asia

Running with Docker

Build and run using Docker Compose or the provided run script. Choose the approach that fits your environment.

docker compose up --build

Configuration

Set runtime options with environment variables and optional proxy configuration.

Claude Desktop integration (MCP proxy config)

The following configuration enables Claude Desktop to connect through an MCP proxy using a streamable HTTP transport.

{
	"mcpServers": {
		"news_streamable": {
			"command": "/opt/homebrew/bin/uv",
			"args": [
				"tool",
				"run",
				"mcp-proxy",
				"--transport",
				"streamablehttp",
				"http://127.0.0.1:8080/mcp"
			]
		}
	}
}

Environment and configuration notes

The server uses a port you expose for clients to connect. Ensure the port is open and not blocked by a firewall.

A sample environment variable is provided for the port the MCP server listens on: MCP_PORT=8000.

Security and troubleshooting

Keep dependencies up to date and review access controls for who can connect to the SSE endpoints. If a retriever fails to start, verify the exact command and path used to start the server components and ensure required ports are accessible.

Available tools

straits_retriever

Fetches live updates from The Straits Times and exposes them as real-time events for clients to subscribe.

business_retriever

Fetches live updates from the Business Times and streams them as events to MCP clients.

cna_retriever

Fetches live updates from Channel News Asia and streams them as events to MCP clients.