Nytimes Article Search Mcp Server
Overview
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
- Visit the Repository: Go to the NYT GitHub page to explore the project.
- Star the Repository: If you find the project interesting, star it to receive updates and show your support.
- Fork the Project: Create your own copy of the repository to experiment with changes or develop new features.
- Contribute: If you have suggestions or improvements, consider submitting a pull request with your changes.
- 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.
Details
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
- Takes
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.
Server Config
{
"mcpServers": {
"nyt": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--angheljf--nyt--nyt",
"node ./build/index.js"
],
"env": {
"NYTIMES_API_KEY": "nytimes-api-key"
}
}
}
}