金大哥 - New York Times MCP 详情

article

README

🚀 纽约时报文章搜索 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，可根据关键词搜索过去 30 天内的《纽约时报》文章。它通过集成《纽约时报》API 这一工具，充分展示了核心 MCP 概念。

NYTimes Article Search

🚀 快速开始

本项目是一个强大的工具，能够助力用户高效搜索过去 30 天内的《纽约时报》文章。下面为你介绍它的使用步骤。

✨ 主要特性

工具

search_articles：根据关键词搜索过去 30 天内的《纽约时报》文章。
- 需传入 keyword 作为必需参数。
- 返回的文章列表包含标题、摘要、URL、发布日期和作者等信息。

📦 安装指南

通过 Smithery 安装

若要通过 Smithery 自动安装《纽约时报》文章搜索以供 Claude Desktop 使用，可执行以下命令：

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

手动安装

若要与 Claude Desktop 一起使用，需添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 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"
      }
    }
  }
}

环境变量设置

在项目根目录中创建一个 .env 文件，并添加您的《纽约时报》API 密钥：

NYTIMES_API_KEY=your_api_key_here

💻 使用示例

基础用法

以下是使用 search_articles 工具的示例：

# 假设已正确安装和配置项目
# 这里只是示意使用 search_articles 工具，实际调用可能需要结合具体代码逻辑

🔧 技术细节

本项目是基于 TypeScript 构建的 MCP 服务器，通过集成《纽约时报》API 实现文章搜索功能。在开发过程中，使用了标准的 Node.js 开发流程，包括依赖安装、项目构建等操作。由于 MCP 服务器通过标准输入输出进行通信，调试时可能存在一定挑战，可借助 MCP Inspector 进行调试。

📚 详细文档

开发

安装依赖

npm install

构建服务器

npm run build

带有自动重建功能的开发

npm run watch

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们建议使用 MCP Inspector，它是作为包脚本提供的：

npm run inspector

Inspector 将提供一个可在浏览器中访问调试工具的 URL。

运行服务器

在构建项目后，可以使用以下命令运行服务器：

node build/index.js

服务器将启动并监听通过标准输入输出的 MCP 请求。

📄 许可证

此项目根据 MIT 许可证发布。

New York Times