Nytimes Article Search Mcp Server

What is NYT?

The NYT (New York Times) repository is a public project hosted on GitHub by the user angheljf. It serves as a platform for developers and enthusiasts to collaborate on projects related to the New York Times, potentially including data analysis, web scraping, or content management related to the newspaper's articles and features.

Features of NYT

• Public Access: The repository is publicly accessible, allowing anyone to view, contribute, and fork the project.
• Collaboration: Users can collaborate on various aspects of the project, including coding, documentation, and testing.
• Open Source: The project is licensed under the MIT license, promoting open-source development and sharing.
• Community Engagement: Users can star the repository to show appreciation and follow updates, as well as fork it to create their own versions.

How to Get Involved with NYT

1. Visit the Repository: Go to the NYT GitHub page to explore the project.
2. Star the Repository: If you find the project interesting, star it to receive updates and show your support.
3. Fork the Project: Create your own copy of the repository to experiment with changes or develop new features.
4. Contribute: If you have suggestions or improvements, consider submitting a pull request with your changes.
5. Engage with the Community: Join discussions, report issues, or ask questions to connect with other contributors.

Frequently Asked Questions

What can I do with the NYT repository?

You can use the NYT repository for various purposes, including data analysis, web scraping, or building applications that utilize New York Times data.

Do I need to be a developer to contribute?

While programming skills are beneficial, anyone can contribute by providing feedback, reporting issues, or suggesting features.

Is there a specific coding style I should follow?

Yes, it's recommended to follow the coding style guidelines provided in the repository's documentation to maintain consistency.

How do I report an issue?

You can report issues by navigating to the "Issues" tab on the repository page and submitting a new issue with a detailed description.

Can I use the NYT data for commercial purposes?

You should check the licensing terms and conditions of the data you are using, as some data may have restrictions on commercial use.

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

<a href="https://glama.ai/mcp/servers/ylg4ai4vin"><img width="380" height="200" src="https://glama.ai/mcp/servers/ylg4ai4vin/badge" alt="NYTimes Article Search Server MCP server" /></a>

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.