What is Nyt

nyt is an MCP server that enables users to search for New York Times articles from the past 30 days using specific keywords. It is built with TypeScript and integrates with the New York Times API.

Use cases

Use cases for nyt include journalists searching for recent articles on specific topics, researchers gathering information for studies, and content creators looking for inspiration from current news.

How to use

To use nyt, you can install it via Smithery or manually configure it in your Claude Desktop application. After installation, you can utilize the ‘search_articles’ tool by providing a keyword to retrieve relevant articles.

Key features

Key features of nyt include the ability to search for articles based on keywords, returning details such as title, abstract, URL, published date, and author. It also supports auto-rebuild during development and debugging through the MCP Inspector.

Where to use

nyt can be used in various fields including journalism, research, and content creation, where access to recent news articles is essential.

NYTimes Article Search MCP Server

This is a TypeScript-based MCP server that allows searching for New York Times articles from the last 30 days based on a keyword. It demonstrates core MCP concepts by providing:

• Tools for searching articles
• Integration with the New York Times API

Features

Tools

• search_articles - Search NYTimes articles from the last 30 days based on a keyword
  • Takes keyword as a required parameter
  • Returns a list of articles with title, abstract, URL, published date, and author

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Installation

Installing via Smithery

To install NYTimes Article Search for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install nyt --client claude

Manual Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nyt": {
      "command": "node",
      "args": [
        "path/to/your/build/index.js"
      ],
      "env": {
        "NYTIMES_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment Variables

Create a .env file in the root of your project and add your New York Times API key:

NYTIMES_API_KEY=your_api_key_here

Running the Server

After building the project, you can run the server with:

node build/index.js

The server will start and listen for MCP requests over stdio.

License

This project is licensed under the MIT License.