home / mcp / mcp news server

MCP News Server

Provides access to top US headlines, article details, AI-powered summarization, and English-to-Korean translation through an MCP server.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ekfaktldk11-mcp-news-server": {
      "command": "node",
      "args": [
        "c:\\Users\\ekfak\\git-repositories\\ai\\mcp-news-server\\dist\\index.js"
      ],
      "env": {
        "NEWS_API_KEY": "your_news_api_key",
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

You set up the MCP News Server to fetch top headlines, inspect specific articles, generate concise summaries with AI, and translate English content into high-quality Korean. This server provides practical, single-purpose tools that you can call from any MCP client to automate news-related tasks.

How to use

You interact with the MCP News Server through an MCP client by calling its available tools. You can pull the top headlines, request detailed information for a specific article, generate a short AI-powered summary, or translate English text into Korean. You can combine these actions, for example by retrieving today’s headlines and then translating the first article into Korean.

How to install

Prerequisites you need before starting are Node.js and npm (or your preferred Node environment). You also should have the necessary API keys for News API and OpenAI ready.

Step by step install and setup:

1) Install dependencies for the project

npm install

2) Create your environment file from the example and fill in your API keys

cp .env.example .env

Open the .env file and set these keys:

NEWS_API_KEY=your_actual_news_api_key
OPENAI_API_KEY=your_actual_openai_api_key

3) Build the project

npm run build

4) Run in development or watch mode (optional)

npm run dev
```

or

```bash
npm run watch

Additional sections

Configuration for client integration can be added to the client’s MCP setup. If you want to run the server locally through your MCP client, you can use the following example configuration to point to the local runtime.

{
  "mcpServers": {
    "mcp_news": {
      "type": "stdio",
      "command": "node",
      "args": ["c:\\Users\\ekfak\\git-repositories\\ai\\mcp-news-server\\dist\\index.js"],
      "env": {
        "NEWS_API_KEY": "your_news_api_key",
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

Troubleshooting and notes

If you encounter issues, verify that your environment variables are correctly set in the .env file and that the API keys you provided are valid. Ensure you have built the project before starting the server. If the MCP client cannot detect the running server, restart the client after building and starting the server.

For development, you can start the server with npm run dev, which enables live updates, or use npm run watch for automatic rebuilds during development.

Available tools

get_top_headlines

Fetches the top 10 US news headlines with optional category filtering (business, entertainment, general, health, science, sports, technology); returns title, source, and publication time.

get_news_details

Retrieves detailed information for a specific news article by its exact title; returns title, source, publication time, description, URL, and author.

summarize_news

Uses AI to summarize a news article text; accepts the article text and an optional maxLength (default 100 words); returns the summarized text.

translate_to_korean

Translates English news text into high-quality Korean.