📌Overview

Purpose: To provide a TypeScript-based MCP server that enables users to search for New York Times articles from the last 30 days using specific keywords.

Overview: The NYTimes Article Search MCP Server serves as a tool for efficiently querying recent articles from the New York Times. It integrates seamlessly with the New York Times API to facilitate article searches and displays relevant information to users.

Key Features:

• Article Search Tool: The search_articles feature allows users to search NYTimes articles from the last 30 days by inputting a keyword, returning details such as title, abstract, URL, published date, and author.

---

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.