NYTimes 文章搜索 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，允许根据关键词搜索过去 30 天内的《纽约时报》文章。它通过提供以下功能来展示核心的 MCP 概念：

• 搜索文章的工具
• 与《纽约时报》API 的集成

功能

工具

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

开发

安装依赖项：

npm install

构建服务器：

npm run build

使用自动重建进行开发：

npm run watch

调试

由于 MCP 服务器通过 stdio 通信，调试可能会比较困难。我们建议使用 MCP Inspector，它可以通过包脚本获得：

npm run inspector

Inspector 将提供一个 URL，以便在浏览器中访问调试工具。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 NYTimes 文章搜索：

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

运行服务器

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

node build/index.js

服务器将启动并通过 stdio 监听 MCP 请求。

许可证

此项目采用 MIT 许可证。